|
Operations on arrays, primitive arrays (like int[]), and primitive wrapper arrays (like Integer[]). This class tries to handle null input gracefully. An exception will not be thrown for a null array input. However, an object array that contains a null element may throw an exception. Each method documents its behavior. public static final java.lang.Object[] EMPTY_OBJECT_ARRAY An empty immutable Object array. public static final java.lang.Class[] EMPTY_CLASS_ARRAY An empty immutable Class array. public static final java.lang.String[] EMPTY_STRING_ARRAY An empty immutable String array. public static final long[] EMPTY_LONG_ARRAY An empty immutable long array. public static final java.lang.Long[] EMPTY_LONG_OBJECT_ARRAY An empty immutable Long array. public static final int[] EMPTY_INT_ARRAY An empty immutable int array. public static final java.lang.Integer[] EMPTY_INTEGER_OBJECT_ARRAY An empty immutable Integer array. public static final short[] EMPTY_SHORT_ARRAY An empty immutable short array. public static final java.lang.Short[] EMPTY_SHORT_OBJECT_ARRAY An empty immutable Short array. public static final byte[] EMPTY_BYTE_ARRAY An empty immutable byte array. public static final java.lang.Byte[] EMPTY_BYTE_OBJECT_ARRAY An empty immutable Byte array. public static final double[] EMPTY_DOUBLE_ARRAY An empty immutable double array. public static final java.lang.Double[] EMPTY_DOUBLE_OBJECT_ARRAY An empty immutable Double array. public static final float[] EMPTY_FLOAT_ARRAY An empty immutable float array. static final java.lang.Float[] EMPTY_FLOAT_OBJECT_ARRAY An empty immutable Float array. public static final boolean[] EMPTY_BOOLEAN_ARRAY An empty immutable boolean array. public static final java.lang.Boolean[] EMPTY_BOOLEAN_OBJECT_ARRAY An empty immutable Boolean array. public static final char[] EMPTY_CHAR_ARRAY An empty immutable char array. public static final java.lang.Character[] EMPTY_CHARACTER_OBJECT_ARRAY An empty immutable Character array. Constructor Detailpublic ArrayUtils() ArrayUtils instances should NOT be constructed in standard programming. Instead, the class should be used as ArrayUtils.clone (new int[] {2}). This constructor is public to permit tools that require a JavaBean instance to operate. Method Detailpublic static java.lang.String toString(java.lang.Object array) Outputs an array as a String, treating null as an empty array. Multi-dimensional arrays are handled correctly, including multi-dimensional primitive arrays. The format is that of Java source code, for example {a,b}. Parameters: arraythe array to get a toString for, may be null Returns: a String representation of the array, '{}' if null array input public static java.lang.String toString(java.lang.Object array, java.lang.String stringIfNull) Outputs an array as a String handling nulls. Multi-dimensional arrays are handled correctly, including multi-dimensional primitive arrays. The format is that of Java source code, for example {a,b}. Parameters: arraythe array to get a toString for, may be null stringIfNullthe String to return if the array is null Returns: a String representation of the array public static int hashCode(java.lang.Object array) Get a hashCode for an array handling multi-dimensional arrays correctly. Multi-dimensional primitive arrays are also handled correctly by this method. Parameters: arraythe array to get a hashCode for, may be null Returns: a hashCode for the array, zero if null array input public static boolean isEquals(java.lang.Object array1, java.lang.Object array2) Compares two arrays, using equals(), handling multi-dimensional arrays correctly. Multi-dimensional primitive arrays are also handled correctly by this method. Parameters: array1the array to get a hashCode for, may be null array2the array to get a hashCode for, may be null Returns: true if the arrays are equal public static java.util.Map toMap(java.lang.Object[] array) Converts the given array into a Map. Each element of the array must be either a Map.Entry or an array, containing at least two elements, where the first element is used as key and the second as value. This method can be used to initialize: // Create a Map mapping colors. Map colorMap = MapUtils.toMap(new String[][] {{ {"RED", "#FF0000"}, {"GREEN", "#00FF00"}, {"BLUE", "#0000FF"}}); This method returns null if null array input. Parameters: arrayan array whose elements are either a Map.Entry or an array containing at least two elements, may be null Returns: a Map that was created from the array Throws: java.lang.IllegalArgumentExceptionif one element of this array is itself an array containing less then two elements java.lang.IllegalArgumentExceptionif the array contains elements other than Map.Entry and an array public static java.lang.Object[] clone(java.lang.Object[] array) Shallow clones an array returning a typecast result and handling null. The objects in the array are not cloned; thus there is no special handling for multi-dimensional arrays. This method returns null if null array input. Parameters: arraythe array to shallow clone, may be null Returns: the cloned array, null if null input public static long[] clone(long[] array) Clones an array returning a typecast result and handling null. This method returns null if null array input. Parameters: arraythe array to clone, may be null Returns: the cloned array, null if null input public static int[] clone(int[] array) Clones an array returning a typecast result and handling null. This method returns null if null array input. Parameters: arraythe array to clone, may be null Returns: the cloned array, null if null input public static short[] clone(short[] array) Clones an array returning a typecast result and handling null. This method returns null if null array input. Parameters: arraythe array to clone, may be null Returns: the cloned array, null if null input public static char[] clone(char[] array) Clones an array returning a typecast result and handling null. This method returns null if null array input. Parameters: arraythe array to clone, may be null Returns: the cloned array, null if null input public static byte[] clone(byte[] array) Clones an array returning a typecast result and handling null. This method returns null if null array input. Parameters: arraythe array to clone, may be null Returns: the cloned array, null if null input public static double[] clone(double[] array) Clones an array returning a typecast result and handling null. This method returns null if null array input. Parameters: arraythe array to clone, may be null Returns: the cloned array, null if null input public static float[] clone(float[] array) Clones an array returning a typecast result and handling null. This method returns null if null array input. Parameters: arraythe array to clone, may be null Returns: the cloned array, null if null input public static boolean[] clone(boolean[] array) Clones an array returning a typecast result and handling null. This method returns null if null array input. Parameters: arraythe array to clone, may be null Returns: the cloned array, null if null input public static boolean isSameLength(java.lang.Object[] array1, java.lang.Object[] array2) Checks whether two arrays are the same length, treating null arrays as length 0. Any multi-dimensional aspects of the arrays are ignored. Parameters: array1the first array, may be null array2the second array, may be null Returns: true if length of arrays matches, treating null as an empty array public static boolean isSameLength(long[] array1, long[] array2) Checks whether two arrays are the same length, treating null arrays as length 0. Parameters: array1the first array, may be null array2the second array, may be null Returns: true if length of arrays matches, treating null as an empty array public static boolean isSameLength(int[] array1, int[] array2) Checks whether two arrays are the same length, treating null arrays as length 0. Parameters: array1the first array, may be null array2the second array, may be null Returns: true if length of arrays matches, treating null as an empty array public static boolean isSameLength(short[] array1, short[] array2) Checks whether two arrays are the same length, treating null arrays as length 0. Parameters: array1the first array, may be null array2the second array, may be null Returns: true if length of arrays matches, treating null as an empty array public static boolean isSameLength(char[] array1, char[] array2) Checks whether two arrays are the same length, treating null arrays as length 0. Parameters: array1the first array, may be null array2the second array, may be null Returns: true if length of arrays matches, treating null as an empty array public static boolean isSameLength(byte[] array1, byte[] array2) Checks whether two arrays are the same length, treating null arrays as length 0. Parameters: array1the first array, may be null array2the second array, may be null Returns: true if length of arrays matches, treating null as an empty array public static boolean isSameLength(double[] array1, double[] array2) Checks whether two arrays are the same length, treating null arrays as length 0. Parameters: array1the first array, may be null array2the second array, may be null Returns: TRue if length of arrays matches, treating null as an empty array public static boolean isSameLength(float[] array1, float[] array2) Checks whether two arrays are the same length, treating null arrays as length 0. Parameters: array1the first array, may be null array2the second array, may be null Returns: TRue if length of arrays matches, treating null as an empty array public static boolean isSameLength(boolean[] array1, boolean[] array2) Checks whether two arrays are the same length, treating null arrays as length 0. Parameters: array1the first array, may be null array2the second array, may be null Returns: true if length of arrays matches, treating null as an empty array public static boolean isSameType(java.lang.Object array1, java.lang.Object array2) Checks whether two arrays are the same type, taking into account multi-dimensional arrays. Parameters: array1the first array, must not be null array2the second array, must not be null Returns: true if type of arrays matches Throws: java.lang.IllegalArgumentExceptionif either array is null public static void reverse(java.lang.Object[] array) Reverses the order of the given array. There is no special handling for multi-dimensional arrays. This method does nothing if null array input. Parameters: arraythe array to reverse, may be null public static void reverse(long[] array) Reverses the order of the given array. This method does nothing if null array input. Parameters: arraythe array to reverse, may be null public static void reverse(int[] array) Reverses the order of the given array. This method does nothing if null array input. Parameters: arraythe array to reverse, may be null public static void reverse(short[] array) Reverses the order of the given array. This method does nothing if null array input. Parameters: arraythe array to reverse, may be null public static void reverse(char[] array) Reverses the order of the given array. This method does nothing if null array input. Parameters: arraythe array to reverse, may be null public static void reverse(byte[] array) Reverses the order of the given array. This method does nothing if null array input. Parameters: arraythe array to reverse, may be null public static void reverse(double[] array) Reverses the order of the given array. This method does nothing if null array input. Parameters: arraythe array to reverse, may be null public static void reverse(float[] array) Reverses the order of the given array. This method does nothing if null array input. Parameters: arraythe array to reverse, may be null public static void reverse(boolean[] array) Reverses the order of the given array. This method does nothing if null array input. Parameters: arraythe array to reverse, may be null public static int indexOf(java.lang.Object[] array, java.lang.Object objectToFind) Find the index of the given object in the array. This method returns -1 if null array input. Parameters: arraythe array to search through for the object, may be null objectToFindthe object to find, may be null Returns: the index of the object within the array, -1 if not found or null array input
Find the index of the given object in the array starting at the given index. This method returns -1 if null array input. A negative startIndex is treated as zero. A startIndex larger than the array length will return -1. Parameters: arraythe array to search through for the object, may be null objectToFindthe object to find, may be null startIndexthe index to start searching at Returns: the index of the object within the array starting at the index, -1 if not found or null array input public static int lastIndexOf(java.lang.Object[] array, java.lang.Object objectToFind) Find the last index of the given object within the array. This method returns -1 if null array input. Parameters: arraythe array to traverse backward looking for the object, may be null objectToFindthe object to find, may be null Returns: the last index of the object within the array, -1 if not found or null array input
Find the last index of the given object in the array starting at the given index. This method returns -1 if null array input. A negative startIndex will return -1. A startIndex larger than the array length will search from the end of the array. Parameters: arraythe array to traverse looking for the object, may be null objectToFindthe object to find, may be null startIndexthe start index to traverse backward from Returns: the last index of the object within the array, -1 if not found or null array input public static boolean contains(java.lang.Object[] array, java.lang.Object objectToFind) Checks if the object is in the given array. The method returns false if a null array is passed in. Parameters: arraythe array to search through objectToFindthe object to find Returns: true if the array contains the object public static int indexOf(long[] array, long valueToFind) Find the index of the given value in the array. This method returns -1 if null array input. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find Returns: the index of the value within the array, -1 if not found or null array input public static int indexOf(long[] array, long valueToFind, int startIndex) Find the index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex is treated as zero. A startIndex larger than the array length will return -1. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find startIndexthe index to start searching at Returns: the index of the value within the array, -1 if not found or null array input public static int lastIndexOf(long[] array, long valueToFind) Find the last index of the given value within the array. This method returns -1 if null array input. Parameters: arraythe array to traverse backward looking for the object, may be null valueToFindthe object to find Returns: the last index of the value within the array, -1 if not found or null array input public static int lastIndexOf(long[] array, long valueToFind, int startIndex) Find the last index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex will return -1. A startIndex larger than the array length will search from the end of the array. Parameters: arraythe array to traverse looking for the object, may be null valueToFindthe value to find startIndexthe start index to traverse backward from Returns: the last index of the value within the array, -1 if not found or null array input public static boolean contains(long[] array, long valueToFind) Checks if the value is in the given array. The method returns false if a null array is passed in. Parameters: arraythe array to search through valueToFindthe value to find Returns: TRue if the array contains the object public static int indexOf(int[] array, int valueToFind) Find the index of the given value in the array. This method returns -1 if null array input. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find Returns: the index of the value within the array, -1 if not found or null array input public static int indexOf(int[] array, int valueToFind, int startIndex) Find the index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex is treated as zero. A startIndex larger than the array length will return -1. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find startIndexthe index to start searching at Returns: the index of the value within the array, -1 if not found or null array input public static int lastIndexOf(int[] array, int valueToFind) Find the last index of the given value within the array. This method returns -1 if null array input. Parameters: arraythe array to traverse backward looking for the object, may be null valueToFindthe object to find Returns: the last index of the value within the array, -1 if not found or null array input public static int lastIndexOf(int[] array, int valueToFind, int startIndex) Find the last index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex will return -1. A startIndex larger than the array length will search from the end of the array. Parameters: arraythe array to traverse looking for the object, may be null valueToFindthe value to find startIndexthe start index to traverse backward from Returns: the last index of the value within the array, -1 if not found or null array input public static boolean contains(int[] array, int valueToFind) Checks if the value is in the given array. The method returns false if a null array is passed in. Parameters: arraythe array to search through valueToFindthe value to find Returns: TRue if the array contains the object public static int indexOf(short[] array, short valueToFind) Find the index of the given value in the array. This method returns -1 if null array input. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find Returns: the index of the value within the array, -1 if not found or null array input public static int indexOf(short[] array, short valueToFind, int startIndex) Find the index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex is treated as zero. A startIndex larger than the array length will return -1. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find startIndexthe index to start searching at Returns: the index of the value within the array, -1 if not found or null array input public static int lastIndexOf(short[] array, short valueToFind) Find the last index of the given value within the array. This method returns -1 if null array input. Parameters: arraythe array to traverse backward looking for the object, may be null valueToFindthe object to find Returns: the last index of the value within the array, -1 if not found or null array input public static int lastIndexOf(short[] array, short valueToFind, int startIndex) Find the last index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex will return -1. A startIndex larger than the array length will search from the end of the array. Parameters: arraythe array to traverse looking for the object, may be null valueToFindthe value to find startIndexthe start index to traverse backward from Returns: the last index of the value within the array, -1 if not found or null array input public static boolean contains(short[] array, short valueToFind) Checks if the value is in the given array. The method returns false if a null array is passed in. Parameters: arraythe array to search through valueToFindthe value to find Returns: TRue if the array contains the object public static int indexOf(byte[] array, byte valueToFind) Find the index of the given value in the array. This method returns -1 if null array input. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find Returns: the index of the value within the array, -1 if not found or null array input public static int indexOf(byte[] array, byte valueToFind, int startIndex) Find the index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex is treated as zero. A startIndex larger than the array length will return -1. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find startIndexthe index to start searching at Returns: the index of the value within the array, -1 if not found or null array input public static int lastIndexOf(byte[] array, byte valueToFind) Find the last index of the given value within the array. This method returns -1 if null array input. Parameters: arraythe array to traverse backward looking for the object, may be null valueToFindthe object to find Returns: the last index of the value within the array, -1 if not found or null array input public static int lastIndexOf(byte[] array, byte valueToFind, int startIndex) Find the last index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex will return -1. A startIndex larger than the array length will search from the end of the array. Parameters: arraythe array to traverse looking for the object, may be null valueToFindthe value to find startIndexthe start index to traverse backward from Returns: the last index of the value within the array, -1 if not found or null array input public static boolean contains(byte[] array, byte valueToFind) Checks if the value is in the given array. The method returns false if a null array is passed in. Parameters: arraythe array to search through valueToFindthe value to find Returns: true if the array contains the object public static int indexOf(double[] array, double valueToFind) Find the index of the given value in the array. This method returns -1 if null array input. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find Returns: the index of the value within the array, -1 if not found or null array input public static int indexOf(double[] array, double valueToFind, double tolerance) Find the index of the given value within a given tolerance in the array. This method will return the index of the first value which falls between the region defined by valueToFind - tolerance and valueToFind + tolerance. This method returns -1 if null array input. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find tolerancetolerance of the search Returns: the index of the value within the array, -1 if not found or null array input public static int indexOf(double[] array, double valueToFind, int startIndex) Find the index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex is treated as zero. A startIndex larger than the array length will return -1. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find startIndexthe index to start searching at Returns: the index of the value within the array, -1 if not found or null array input public static int indexOf(double[] array, double valueToFind, int startIndex, double tolerance) Find the index of the given value in the array starting at the given index. This method will return the index of the first value which falls between the region defined by valueToFind - tolerance and valueToFind + tolerance. This method returns -1 if null array input. A negative startIndex is treated as zero. A startIndex larger than the array length will return -1. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find startIndexthe index to start searching at tolerancetolerance of the search Returns: the index of the value within the array, -1 if not found or null array input public static int lastIndexOf(double[] array, double valueToFind) Find the last index of the given value within the array. This method returns -1 if null array input. Parameters: arraythe array to traverse backward looking for the object, may be null valueToFindthe object to find Returns: the last index of the value within the array, -1 if not found or null array input public static int lastIndexOf(double[] array, double valueToFind, double tolerance) Find the last index of the given value within a given tolerance in the array. This method will return the index of the last value which falls between the region defined by valueToFind - tolerance and valueToFind + tolerance. This method returns -1 if null array input. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find tolerancetolerance of the search Returns: the index of the value within the array, -1 if not found or null array input public static int lastIndexOf(double[] array, double valueToFind, int startIndex) Find the last index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex will return -1. A startIndex larger than the array length will search from the end of the array. Parameters: arraythe array to traverse looking for the object, may be null valueToFindthe value to find startIndexthe start index to traverse backward from Returns: the last index of the value within the array, -1 if not found or null array input
Find the last index of the given value in the array starting at the given index. This method will return the index of the last value which falls between the region defined by valueToFind - tolerance and valueToFind + tolerance. This method returns -1 if null array input. A negative startIndex will return -1. A startIndex larger than the array length will search from the end of the array. Parameters: arraythe array to traverse looking for the object, may be null valueToFindthe value to find startIndexthe start index to traverse backward from tolerancesearch for value within plus/minus this amount Returns: the last index of the value within the array, -1 if not found or null array input public static boolean contains(double[] array, double valueToFind) Checks if the value is in the given array. The method returns false if a null array is passed in. Parameters: arraythe array to search through valueToFindthe value to find Returns: TRue if the array contains the object public static boolean contains(double[] array, double valueToFind, double tolerance) Checks if a value falling within the given tolerance is in the given array. If the array contains a value within the inclusive range defined by (value - tolerance) to (value + tolerance). The method returns false if a null array is passed in. Parameters: arraythe array to search valueToFindthe value to find tolerancethe array contains the tolerance of the search Returns: true if value falling within tolerance is in array public static int indexOf(float[] array, float valueToFind) Find the index of the given value in the array. This method returns -1 if null array input. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find Returns: the index of the value within the array, -1 if not found or null array input public static int indexOf(float[] array, float valueToFind, int startIndex) Find the index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex is treated as zero. A startIndex larger than the array length will return -1. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find startIndexthe index to start searching at Returns: the index of the value within the array, -1 if not found or null array input public static int lastIndexOf(float[] array, float valueToFind) Find the last index of the given value within the array. This method returns -1 if null array input. Parameters: arraythe array to traverse backward looking for the object, may be null valueToFindthe object to find Returns: the last index of the value within the array, -1 if not found or null array input public static int lastIndexOf(float[] array, float valueToFind, int startIndex) Find the last index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex will return -1. A startIndex larger than the array length will search from the end of the array. Parameters: arraythe array to traverse looking for the object, may be null valueToFindthe value to find startIndexthe start index to traverse backward from Returns: the last index of the value within the array, -1 if not found or null array input public static boolean contains(float[] array, float valueToFind) Checks if the value is in the given array. The method returns false if a null array is passed in. Parameters: arraythe array to search through valueToFindthe value to find Returns: TRue if the array contains the object public static int indexOf(boolean[] array, boolean valueToFind) Find the index of the given value in the array. This method returns -1 if null array input. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find Returns: the index of the value within the array, -1 if not found or null array input public static int indexOf(boolean[] array, boolean valueToFind, int startIndex) Find the index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex is treated as zero. A startIndex larger than the array length will return -1. Parameters: arraythe array to search through for the object, may be null valueToFindthe value to find startIndexthe index to start searching at Returns: the index of the value within the array, -1 if not found or null array input public static int lastIndexOf(boolean[] array, boolean valueToFind) Find the last index of the given value within the array. This method returns -1 if null array input. Parameters: arraythe array to traverse backward looking for the object, may be null valueToFindthe object to find Returns: the last index of the value within the array, -1 if not found or null array input public static int lastIndexOf(boolean[] array, boolean valueToFind, int startIndex) Find the last index of the given value in the array starting at the given index. This method returns -1 if null array input. A negative startIndex will return -1. A startIndex larger than the array length will search from the end of the array. Parameters: arraythe array to traverse looking for the object, may be null valueToFindthe value to find startIndexthe start index to traverse backward from Returns: the last index of the value within the array, -1 if not found or null array input public static boolean contains(boolean[] array, boolean valueToFind) Checks if the value is in the given array. The method returns false if a null array is passed in. Parameters: arraythe array to search through valueToFindthe value to find Returns: TRue if the array contains the object public static long[] toPrimitive(java.lang.Long[] array) Converts an array of object Longs to primitives. This method returns null if null array input. Parameters: arraya Long array, may be null Returns: a long array, null if null array input Throws: java.lang.NullPointerExceptionif array content is null public static long[] toPrimitive(java.lang.Long[] array, long valueForNull) Converts an array of object Long to primitives handling null. This method returns null if null array input. Parameters: arraya Long array, may be null valueForNullthe value to insert if null found Returns: a long array, null if null array input public static java.lang.Long[] toObject(long[] array) Converts an array of primitive longs to objects. This method returns null if null array input. Parameters: arraya long array Returns: a Long array, null if null array input public static int[] toPrimitive(java.lang.Integer[] array) Converts an array of object Integers to primitives. This method returns null if null array input. Parameters: arrayan Integer array, may be null Returns: an int array, null if null array input Throws: java.lang.NullPointerExceptionif array content is null public static int[] toPrimitive(java.lang.Integer[] array, int valueForNull) Converts an array of object Integer to primitives handling null. This method returns null if null array input. Parameters: arrayan Integer array, may be null valueForNullthe value to insert if null found Returns: an int array, null if null array input public static java.lang.Integer[] toObject(int[] array) Converts an array of primitive ints to objects. This method returns null if null array input. Parameters: arrayan int array Returns: an Integer array, null if null array input public static short[] toPrimitive(java.lang.Short[] array) Converts an array of object Shorts to primitives. This method returns null if null array input. Parameters: arraya Short array, may be null Returns: a byte array, null if null array input Throws: java.lang.NullPointerExceptionif array content is null public static short[] toPrimitive(java.lang.Short[] array, short valueForNull) Converts an array of object Short to primitives handling null. This method returns null if null array input. Parameters: arraya Short array, may be null valueForNullthe value to insert if null found Returns: a byte array, null if null array input public static java.lang.Short[] toObject(short[] array) Converts an array of primitive shorts to objects. This method returns null if null array input. Parameters: arraya short array Returns: a Short array, null if null array input public static byte[] toPrimitive(java.lang.Byte[] array) Converts an array of object Bytes to primitives. This method returns null if null array input. Parameters: arraya Byte array, may be null Returns: a byte array, null if null array input Throws: java.lang.NullPointerExceptionif array content is null public static byte[] toPrimitive(java.lang.Byte[] array, byte valueForNull) Converts an array of object Bytes to primitives handling null. This method returns null if null array input. Parameters: arraya Byte array, may be null valueForNullthe value to insert if null found Returns: a byte array, null if null array input public static java.lang.Byte[] toObject(byte[] array) Converts an array of primitive bytes to objects. This method returns null if null array input. Parameters: arraya byte array Returns: a Byte array, null if null array input public static double[] toPrimitive(java.lang.Double[] array) Converts an array of object Doubles to primitives. This method returns null if null array input. Parameters: arraya Double array, may be null Returns: a double array, null if null array input Throws: java.lang.NullPointerExceptionif array content is null public static double[] toPrimitive(java.lang.Double[] array, double valueForNull) Converts an array of object Doubles to primitives handling null. This method returns null if null array input. Parameters: arraya Double array, may be null valueForNullthe value to insert if null found Returns: a double array, null if null array input public static java.lang.Double[] toObject(double[] array) Converts an array of primitive doubles to objects. This method returns null if null array input. Parameters: arraya double array Returns: a Double array, null if null array input public static float[] toPrimitive(java.lang.Float[] array) Converts an array of object Floats to primitives. This method returns null if null array input. Parameters: arraya Float array, may be null Returns: a float array, null if null array input Throws: java.lang.NullPointerExceptionif array content is null public static float[] toPrimitive(java.lang.Float[] array, float valueForNull) Converts an array of object Floats to primitives handling null. This method returns null if null array input. Parameters: arraya Float array, may be null valueForNullthe value to insert if null found Returns: a float array, null if null array input public static java.lang.Float[] toObject(float[] array) Converts an array of primitive floats to objects. This method returns null if null array input. Parameters: arraya float array Returns: a Float array, null if null array input public static boolean[] toPrimitive(java.lang.Boolean[] array) Converts an array of object Booleans to primitives. This method returns null if null array input. Parameters: arraya Boolean array, may be null Returns: a boolean array, null if null array input Throws: java.lang.NullPointerExceptionif array content is null public static boolean[] toPrimitive(java.lang.Boolean[] array, boolean valueForNull) Converts an array of object Booleans to primitives handling null. This method returns null if null array input. Parameters: arraya Boolean array, may be null valueForNullthe value to insert if null found Returns: a boolean array, null if null array input public static java.lang.Boolean[] toObject(boolean[] array) Converts an array of primitive booleans to objects. This method returns null if null array input. Parameters: arraya boolean array Returns: a Boolean array, null if null array input |
|