org.apache.commons.lang.ArrayUtils


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 Detail

 public 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 Detail

 public 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

[View full width]

public static int indexOf(java.lang.Object[] array, java.lang.Object objectToFind, int startIndex)

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

[View full width]

public static int lastIndexOf(java.lang.Object[] array, java.lang.Object objectToFind, int startIndex)

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

[View full width]

public static int lastIndexOf(double[] array, double valueToFind, int startIndex, double tolerance)

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



    Apache Jakarta Commons(c) Reusable Java Components
    Real World Web Services
    ISBN: N/A
    EAN: 2147483647
    Year: 2006
    Pages: 137
    Authors: Will Iverson

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net