com.landawn.abacus.util

Class Primitives

java.lang.Object

com.landawn.abacus.util.Primitives

public final class Primitives
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Primitives.Booleans
static class	Primitives.Bytes
static class	Primitives.Chars
static class	Primitives.Doubles
static class	Primitives.Floats
static class	Primitives.Ints
static class	Primitives.Longs
static class	Primitives.Shorts

Method Summary

Modifier and Type	Method and Description
static java.lang.Boolean[]	box(boolean... a) Converts an array of primitive booleans to objects.
static java.lang.Boolean[][]	box(boolean[][] a)
static java.lang.Boolean[][][]	box(boolean[][][] a)
static java.lang.Boolean[]	box(boolean[] a, int fromIndex, int toIndex)
static java.lang.Byte[]	box(byte... a) Converts an array of primitive bytes to objects.
static java.lang.Byte[][]	box(byte[][] a)
static java.lang.Byte[][][]	box(byte[][][] a)
static java.lang.Byte[]	box(byte[] a, int fromIndex, int toIndex)
static java.lang.Character[]	box(char... a) Converts an array of primitive chars to objects.
static java.lang.Character[][]	box(char[][] a)
static java.lang.Character[][][]	box(char[][][] a)
static java.lang.Character[]	box(char[] a, int fromIndex, int toIndex)
static java.lang.Double[]	box(double... a) Converts an array of primitive doubles to objects.
static java.lang.Double[][]	box(double[][] a)
static java.lang.Double[][][]	box(double[][][] a)
static java.lang.Double[]	box(double[] a, int fromIndex, int toIndex)
static java.lang.Float[]	box(float... a) Converts an array of primitive floats to objects.
static java.lang.Float[][]	box(float[][] a)
static java.lang.Float[][][]	box(float[][][] a)
static java.lang.Float[]	box(float[] a, int fromIndex, int toIndex)
static java.lang.Integer[]	box(int... a) Converts an array of primitive ints to objects.
static java.lang.Integer[][]	box(int[][] a)
static java.lang.Integer[][][]	box(int[][][] a)
static java.lang.Integer[]	box(int[] a, int fromIndex, int toIndex)
static java.lang.Long[]	box(long... a) Converts an array of primitive longs to objects.
static java.lang.Long[][]	box(long[][] a)
static java.lang.Long[][][]	box(long[][][] a)
static java.lang.Long[]	box(long[] a, int fromIndex, int toIndex)
static java.lang.Short[]	box(short... a) Converts an array of primitive shorts to objects.
static java.lang.Short[][]	box(short[][] a)
static java.lang.Short[][][]	box(short[][][] a)
static java.lang.Short[]	box(short[] a, int fromIndex, int toIndex)
static boolean	isPrimitiveArrayType(java.lang.Class<?> cls)
static boolean	isPrimitiveType(java.lang.Class<?> cls)
static boolean	isWrapperType(java.lang.Class<?> cls)
static boolean[]	unbox(java.lang.Boolean... a) Converts an array of object Booleans to primitives.
static boolean[][]	unbox(java.lang.Boolean[][] a)
static boolean[][][]	unbox(java.lang.Boolean[][][] a)
static boolean[][][]	unbox(java.lang.Boolean[][][] a, boolean valueForNull)
static boolean[][]	unbox(java.lang.Boolean[][] a, boolean valueForNull)
static boolean[]	unbox(java.lang.Boolean[] a, boolean valueForNull) Converts an array of object Booleans to primitives handling null.
static boolean[]	unbox(java.lang.Boolean[] a, int fromIndex, int toIndex, boolean valueForNull)
static byte[]	unbox(java.lang.Byte... a) Converts an array of object Bytes to primitives.
static byte[][]	unbox(java.lang.Byte[][] a)
static byte[][][]	unbox(java.lang.Byte[][][] a)
static byte[][][]	unbox(java.lang.Byte[][][] a, byte valueForNull)
static byte[][]	unbox(java.lang.Byte[][] a, byte valueForNull)
static byte[]	unbox(java.lang.Byte[] a, byte valueForNull) Converts an array of object Bytes to primitives handling null.
static byte[]	unbox(java.lang.Byte[] a, int fromIndex, int toIndex, byte valueForNull)
static char[]	unbox(java.lang.Character... a) Converts an array of object Characters to primitives.
static char[][]	unbox(java.lang.Character[][] a)
static char[][][]	unbox(java.lang.Character[][][] a)
static char[][][]	unbox(java.lang.Character[][][] a, char valueForNull)
static char[][]	unbox(java.lang.Character[][] a, char valueForNull)
static char[]	unbox(java.lang.Character[] a, char valueForNull) Converts an array of object Character to primitives handling null .
static char[]	unbox(java.lang.Character[] a, int fromIndex, int toIndex, char valueForNull)
static double[]	unbox(java.lang.Double... a) Converts an array of object Doubles to primitives.
static double[][]	unbox(java.lang.Double[][] a)
static double[][][]	unbox(java.lang.Double[][][] a)
static double[][][]	unbox(java.lang.Double[][][] a, double valueForNull)
static double[][]	unbox(java.lang.Double[][] a, double valueForNull)
static double[]	unbox(java.lang.Double[] a, double valueForNull) Converts an array of object Doubles to primitives handling null.
static double[]	unbox(java.lang.Double[] a, int fromIndex, int toIndex, double valueForNull)
static float[]	unbox(java.lang.Float... a) Converts an array of object Floats to primitives.
static float[][]	unbox(java.lang.Float[][] a)
static float[][][]	unbox(java.lang.Float[][][] a)
static float[][][]	unbox(java.lang.Float[][][] a, float valueForNull)
static float[][]	unbox(java.lang.Float[][] a, float valueForNull)
static float[]	unbox(java.lang.Float[] a, float valueForNull) Converts an array of object Floats to primitives handling null.
static float[]	unbox(java.lang.Float[] a, int fromIndex, int toIndex, float valueForNull)
static int[]	unbox(java.lang.Integer... a) Converts an array of object Integers to primitives.
static int[][]	unbox(java.lang.Integer[][] a)
static int[][][]	unbox(java.lang.Integer[][][] a)
static int[][][]	unbox(java.lang.Integer[][][] a, int valueForNull)
static int[][]	unbox(java.lang.Integer[][] a, int valueForNull)
static int[]	unbox(java.lang.Integer[] a, int valueForNull) Converts an array of object Integer to primitives handling null.
static int[]	unbox(java.lang.Integer[] a, int fromIndex, int toIndex, int valueForNull)
static long[]	unbox(java.lang.Long... a) Converts an array of object Longs to primitives.
static long[][]	unbox(java.lang.Long[][] a)
static long[][][]	unbox(java.lang.Long[][][] a)
static long[][][]	unbox(java.lang.Long[][][] a, long valueForNull)
static long[][]	unbox(java.lang.Long[][] a, long valueForNull)
static long[]	unbox(java.lang.Long[] a, int fromIndex, int toIndex, long valueForNull)
static long[]	unbox(java.lang.Long[] a, long valueForNull) Converts an array of object Long to primitives handling null.
static short[]	unbox(java.lang.Short... a) Converts an array of object Shorts to primitives.
static short[][]	unbox(java.lang.Short[][] a)
static short[][][]	unbox(java.lang.Short[][][] a)
static short[][][]	unbox(java.lang.Short[][][] a, short valueForNull)
static short[][]	unbox(java.lang.Short[][] a, short valueForNull)
static short[]	unbox(java.lang.Short[] a, int fromIndex, int toIndex, short valueForNull)
static short[]	unbox(java.lang.Short[] a, short valueForNull) Converts an array of object Short to primitives handling null.
static boolean	unboxOrDefault(java.lang.Boolean b)
static boolean	unboxOrDefault(java.lang.Boolean b, boolean defaultForNull)
static byte	unboxOrDefault(java.lang.Byte b)
static byte	unboxOrDefault(java.lang.Byte b, byte defaultForNull)
static char	unboxOrDefault(java.lang.Character c)
static char	unboxOrDefault(java.lang.Character c, char defaultForNull)
static double	unboxOrDefault(java.lang.Double b)
static double	unboxOrDefault(java.lang.Double b, double defaultForNull)
static float	unboxOrDefault(java.lang.Float b)
static float	unboxOrDefault(java.lang.Float b, float defaultForNull)
static int	unboxOrDefault(java.lang.Integer b)
static int	unboxOrDefault(java.lang.Integer b, int defaultForNull)
static long	unboxOrDefault(java.lang.Long b)
static long	unboxOrDefault(java.lang.Long b, long defaultForNull)
static short	unboxOrDefault(java.lang.Short b)
static short	unboxOrDefault(java.lang.Short b, short defaultForNull)
static boolean	unboxOrGet(java.lang.Boolean b, BooleanSupplier supplierForNull)
static byte	unboxOrGet(java.lang.Byte b, ByteSupplier supplierForNull)
static char	unboxOrGet(java.lang.Character b, CharSupplier supplierForNull)
static double	unboxOrGet(java.lang.Double b, DoubleSupplier supplierForNull)
static float	unboxOrGet(java.lang.Float b, FloatSupplier supplierForNull)
static int	unboxOrGet(java.lang.Integer b, IntSupplier supplierForNull)
static long	unboxOrGet(java.lang.Long b, LongSupplier supplierForNull)
static short	unboxOrGet(java.lang.Short b, ShortSupplier supplierForNull)
static java.lang.Class<?>	unwrap(java.lang.Class<?> cls) Returns the corresponding primitive type of type if it is a wrapper type; otherwise returns type itself.
static java.lang.Class<?>	wrap(java.lang.Class<?> cls) Returns the corresponding wrapper type of type if it is a primitive type; otherwise returns type itself.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

isPrimitiveType

public static boolean isPrimitiveType(java.lang.Class<?> cls)

isWrapperType

public static boolean isWrapperType(java.lang.Class<?> cls)

isPrimitiveArrayType

public static boolean isPrimitiveArrayType(java.lang.Class<?> cls)

wrap

public static java.lang.Class<?> wrap(java.lang.Class<?> cls)

Returns the corresponding wrapper type of type if it is a primitive type; otherwise returns type itself. Idempotent.

     wrap(int.class) == Integer.class
     wrap(Integer.class) == Integer.class
     wrap(String.class) == String.class
 

unwrap

public static java.lang.Class<?> unwrap(java.lang.Class<?> cls)

Returns the corresponding primitive type of type if it is a wrapper type; otherwise returns type itself. Idempotent.

     unwrap(Integer.class) == int.class
     unwrap(int.class) == int.class
     unwrap(String.class) == String.class
 

box

@SafeVarargs
public static java.lang.Boolean[] box(boolean... a)

Converts an array of primitive booleans to objects.

This method returns null for a null input array.

Parameters:

a - a boolean array

Returns:

a Boolean array, null if null array input

box

public static java.lang.Boolean[] box(boolean[] a,
                                      int fromIndex,
                                      int toIndex)

box

@SafeVarargs
public static java.lang.Character[] box(char... a)

Converts an array of primitive chars to objects.

This method returns null for a null input array.

Parameters:

a - a char array

Returns:

a Character array, null if null array input

box

public static java.lang.Character[] box(char[] a,
                                        int fromIndex,
                                        int toIndex)

box

@SafeVarargs
public static java.lang.Byte[] box(byte... a)

Converts an array of primitive bytes to objects.

This method returns null for a null input array.

Parameters:

a - a byte array

Returns:

a Byte array, null if null array input

box

public static java.lang.Byte[] box(byte[] a,
                                   int fromIndex,
                                   int toIndex)

box

@SafeVarargs
public static java.lang.Short[] box(short... a)

Converts an array of primitive shorts to objects.

This method returns null for a null input array.

Parameters:

a - a short array

Returns:

a Short array, null if null array input

box

public static java.lang.Short[] box(short[] a,
                                    int fromIndex,
                                    int toIndex)

box

@SafeVarargs
public static java.lang.Integer[] box(int... a)

Converts an array of primitive ints to objects.

This method returns null for a null input array.

Parameters:

a - an int array

Returns:

an Integer array, null if null array input

box

public static java.lang.Integer[] box(int[] a,
                                      int fromIndex,
                                      int toIndex)

box

@SafeVarargs
public static java.lang.Long[] box(long... a)

Converts an array of primitive longs to objects.

This method returns null for a null input array.

Parameters:

a - a long array

Returns:

a Long array, null if null array input

box

public static java.lang.Long[] box(long[] a,
                                   int fromIndex,
                                   int toIndex)

box

@SafeVarargs
public static java.lang.Float[] box(float... a)

Converts an array of primitive floats to objects.

This method returns null for a null input array.

Parameters:

a - a float array

Returns:

a Float array, null if null array input

box

public static java.lang.Float[] box(float[] a,
                                    int fromIndex,
                                    int toIndex)

box

@SafeVarargs
public static java.lang.Double[] box(double... a)

Converts an array of primitive doubles to objects.

This method returns null for a null input array.

Parameters:

a - a double array

Returns:

a Double array, null if null array input

box

public static java.lang.Double[] box(double[] a,
                                     int fromIndex,
                                     int toIndex)

box

public static java.lang.Boolean[][] box(boolean[][] a)

box

public static java.lang.Character[][] box(char[][] a)

box

public static java.lang.Byte[][] box(byte[][] a)

box

public static java.lang.Short[][] box(short[][] a)

box

public static java.lang.Integer[][] box(int[][] a)

box

public static java.lang.Long[][] box(long[][] a)

box

public static java.lang.Float[][] box(float[][] a)

box

public static java.lang.Double[][] box(double[][] a)

box

public static java.lang.Boolean[][][] box(boolean[][][] a)

box

public static java.lang.Character[][][] box(char[][][] a)

box

public static java.lang.Byte[][][] box(byte[][][] a)

box

public static java.lang.Short[][][] box(short[][][] a)

box

public static java.lang.Integer[][][] box(int[][][] a)

box

public static java.lang.Long[][][] box(long[][][] a)

box

public static java.lang.Float[][][] box(float[][][] a)

box

public static java.lang.Double[][][] box(double[][][] a)

unbox

@SafeVarargs
public static boolean[] unbox(java.lang.Boolean... a)

Converts an array of object Booleans to primitives.

This method returns null for a null input array.

Parameters:

a - a Boolean array, may be null

Returns:

a boolean array, null if null array input

unbox

public static boolean[] unbox(java.lang.Boolean[] a,
                              boolean valueForNull)

Converts an array of object Booleans to primitives handling null.

This method returns null for a null input array.

Parameters:

a - a Boolean array, may be null

valueForNull - the value to insert if null found

Returns:

a boolean array, null if null array input

unbox

public static boolean[] unbox(java.lang.Boolean[] a,
                              int fromIndex,
                              int toIndex,
                              boolean valueForNull)

unbox

@SafeVarargs
public static char[] unbox(java.lang.Character... a)

Converts an array of object Characters to primitives.

This method returns null for a null input array.

Parameters:

a - a Character array, may be null

Returns:

a char array, null if null array input

unbox

public static char[] unbox(java.lang.Character[] a,
                           char valueForNull)

Converts an array of object Character to primitives handling null .

This method returns null for a null input array.

Parameters:

a - a Character array, may be null

valueForNull - the value to insert if null found

Returns:

a char array, null if null array input

unbox

public static char[] unbox(java.lang.Character[] a,
                           int fromIndex,
                           int toIndex,
                           char valueForNull)

unbox

@SafeVarargs
public static byte[] unbox(java.lang.Byte... a)

Converts an array of object Bytes to primitives.

This method returns null for a null input array.

Parameters:

a - a Byte array, may be null

Returns:

a byte array, null if null array input

unbox

public static byte[] unbox(java.lang.Byte[] a,
                           byte valueForNull)

Converts an array of object Bytes to primitives handling null.

This method returns null for a null input array.

Parameters:

a - a Byte array, may be null

valueForNull - the value to insert if null found

Returns:

a byte array, null if null array input

unbox

public static byte[] unbox(java.lang.Byte[] a,
                           int fromIndex,
                           int toIndex,
                           byte valueForNull)

unbox

@SafeVarargs
public static short[] unbox(java.lang.Short... a)

Converts an array of object Shorts to primitives.

This method returns null for a null input array.

Parameters:

a - a Short array, may be null

Returns:

a byte array, null if null array input

unbox

public static short[] unbox(java.lang.Short[] a,
                            short valueForNull)

Converts an array of object Short to primitives handling null.

This method returns null for a null input array.

Parameters:

a - a Short array, may be null

valueForNull - the value to insert if null found

Returns:

a byte array, null if null array input

unbox

public static short[] unbox(java.lang.Short[] a,
                            int fromIndex,
                            int toIndex,
                            short valueForNull)

unbox

@SafeVarargs
public static int[] unbox(java.lang.Integer... a)

Converts an array of object Integers to primitives.

This method returns null for a null input array.

Parameters:

a - a Integer array, may be null

Returns:

an int array, null if null array input

unbox

public static int[] unbox(java.lang.Integer[] a,
                          int valueForNull)

Converts an array of object Integer to primitives handling null.

This method returns null for a null input array.

Parameters:

a - a Integer array, may be null

valueForNull - the value to insert if null found

Returns:

an int array, null if null array input

unbox

public static int[] unbox(java.lang.Integer[] a,
                          int fromIndex,
                          int toIndex,
                          int valueForNull)

unbox

@SafeVarargs
public static long[] unbox(java.lang.Long... a)

Converts an array of object Longs to primitives.

This method returns null for a null input array.

Parameters:

a - a Long array, may be null

Returns:

a long array, null if null array input

unbox

public static long[] unbox(java.lang.Long[] a,
                           long valueForNull)

Converts an array of object Long to primitives handling null.

This method returns null for a null input array.

Parameters:

a - a Long array, may be null

valueForNull - the value to insert if null found

Returns:

a long array, null if null array input

unbox

public static long[] unbox(java.lang.Long[] a,
                           int fromIndex,
                           int toIndex,
                           long valueForNull)

unbox

@SafeVarargs
public static float[] unbox(java.lang.Float... a)

Converts an array of object Floats to primitives.

This method returns null for a null input array.

Parameters:

a - a Float array, may be null

Returns:

a float array, null if null array input

unbox

public static float[] unbox(java.lang.Float[] a,
                            float valueForNull)

Converts an array of object Floats to primitives handling null.

This method returns null for a null input array.

Parameters:

a - a Float array, may be null

valueForNull - the value to insert if null found

Returns:

a float array, null if null array input

unbox

public static float[] unbox(java.lang.Float[] a,
                            int fromIndex,
                            int toIndex,
                            float valueForNull)

unbox

@SafeVarargs
public static double[] unbox(java.lang.Double... a)

Converts an array of object Doubles to primitives.

This method returns null for a null input array.

Parameters:

a - a Double array, may be null

Returns:

a double array, null if null array input

unbox

public static double[] unbox(java.lang.Double[] a,
                             double valueForNull)

Converts an array of object Doubles to primitives handling null.

This method returns null for a null input array.

Parameters:

a - a Double array, may be null

valueForNull - the value to insert if null found

Returns:

a double array, null if null array input

unbox

public static double[] unbox(java.lang.Double[] a,
                             int fromIndex,
                             int toIndex,
                             double valueForNull)

unbox

public static boolean[][] unbox(java.lang.Boolean[][] a)

unbox

public static boolean[][] unbox(java.lang.Boolean[][] a,
                                boolean valueForNull)

unbox

public static char[][] unbox(java.lang.Character[][] a)

unbox

public static char[][] unbox(java.lang.Character[][] a,
                             char valueForNull)

unbox

public static byte[][] unbox(java.lang.Byte[][] a)

unbox

public static byte[][] unbox(java.lang.Byte[][] a,
                             byte valueForNull)

unbox

public static short[][] unbox(java.lang.Short[][] a)

unbox

public static short[][] unbox(java.lang.Short[][] a,
                              short valueForNull)

unbox

public static int[][] unbox(java.lang.Integer[][] a)

unbox

public static int[][] unbox(java.lang.Integer[][] a,
                            int valueForNull)

unbox

public static long[][] unbox(java.lang.Long[][] a)

unbox

public static long[][] unbox(java.lang.Long[][] a,
                             long valueForNull)

unbox

public static float[][] unbox(java.lang.Float[][] a)

unbox

public static float[][] unbox(java.lang.Float[][] a,
                              float valueForNull)

unbox

public static double[][] unbox(java.lang.Double[][] a)

unbox

public static double[][] unbox(java.lang.Double[][] a,
                               double valueForNull)

unbox

public static boolean[][][] unbox(java.lang.Boolean[][][] a)

unbox

public static boolean[][][] unbox(java.lang.Boolean[][][] a,
                                  boolean valueForNull)

unbox

public static char[][][] unbox(java.lang.Character[][][] a)

unbox

public static char[][][] unbox(java.lang.Character[][][] a,
                               char valueForNull)

unbox

public static byte[][][] unbox(java.lang.Byte[][][] a)

unbox

public static byte[][][] unbox(java.lang.Byte[][][] a,
                               byte valueForNull)

unbox

public static short[][][] unbox(java.lang.Short[][][] a)

unbox

public static short[][][] unbox(java.lang.Short[][][] a,
                                short valueForNull)

unbox

public static int[][][] unbox(java.lang.Integer[][][] a)

unbox

public static int[][][] unbox(java.lang.Integer[][][] a,
                              int valueForNull)

unbox

public static long[][][] unbox(java.lang.Long[][][] a)

unbox

public static long[][][] unbox(java.lang.Long[][][] a,
                               long valueForNull)

unbox

public static float[][][] unbox(java.lang.Float[][][] a)

unbox

public static float[][][] unbox(java.lang.Float[][][] a,
                                float valueForNull)

unbox

public static double[][][] unbox(java.lang.Double[][][] a)

unbox

public static double[][][] unbox(java.lang.Double[][][] a,
                                 double valueForNull)

unboxOrDefault

public static boolean unboxOrDefault(java.lang.Boolean b)

unboxOrDefault

public static boolean unboxOrDefault(java.lang.Boolean b,
                                     boolean defaultForNull)

unboxOrDefault

public static char unboxOrDefault(java.lang.Character c)

unboxOrDefault

public static char unboxOrDefault(java.lang.Character c,
                                  char defaultForNull)

unboxOrDefault

public static byte unboxOrDefault(java.lang.Byte b)

unboxOrDefault

public static byte unboxOrDefault(java.lang.Byte b,
                                  byte defaultForNull)

unboxOrDefault

public static short unboxOrDefault(java.lang.Short b)

unboxOrDefault

public static short unboxOrDefault(java.lang.Short b,
                                   short defaultForNull)

unboxOrDefault

public static int unboxOrDefault(java.lang.Integer b)

unboxOrDefault

public static int unboxOrDefault(java.lang.Integer b,
                                 int defaultForNull)

unboxOrDefault

public static long unboxOrDefault(java.lang.Long b)

unboxOrDefault

public static long unboxOrDefault(java.lang.Long b,
                                  long defaultForNull)

unboxOrDefault

public static float unboxOrDefault(java.lang.Float b)

unboxOrDefault

public static float unboxOrDefault(java.lang.Float b,
                                   float defaultForNull)

unboxOrDefault

public static double unboxOrDefault(java.lang.Double b)

unboxOrDefault

public static double unboxOrDefault(java.lang.Double b,
                                    double defaultForNull)

unboxOrGet

public static boolean unboxOrGet(java.lang.Boolean b,
                                 BooleanSupplier supplierForNull)

unboxOrGet

public static char unboxOrGet(java.lang.Character b,
                              CharSupplier supplierForNull)

unboxOrGet

public static byte unboxOrGet(java.lang.Byte b,
                              ByteSupplier supplierForNull)

unboxOrGet

public static short unboxOrGet(java.lang.Short b,
                               ShortSupplier supplierForNull)

unboxOrGet

public static int unboxOrGet(java.lang.Integer b,
                             IntSupplier supplierForNull)

unboxOrGet

public static long unboxOrGet(java.lang.Long b,
                              LongSupplier supplierForNull)

unboxOrGet

public static float unboxOrGet(java.lang.Float b,
                               FloatSupplier supplierForNull)

unboxOrGet

public static double unboxOrGet(java.lang.Double b,
                                DoubleSupplier supplierForNull)