ArrayUtils (Core Language Utilities (Version 2.0))

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.commons.lang
Class ArrayUtils

java.lang.Object
  org.apache.commons.lang.ArrayUtils

public class ArrayUtils
extends Object

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 behaviour.

Since:: 2.0
Version:: $Id: ArrayUtils.java,v 1.25 2003/08/22 17:25:33 ggregory Exp $
Author:: Stephen Colebourne, Moritz Petersen, Fredrik Westermarck, Nikolay Metchev, Matthew Hawthorne, Tim O'Brien, Pete Gieser, Gary Gregory

Field Summary
`static boolean[]`	`EMPTY_BOOLEAN_ARRAY` An empty immutable `boolean` array.
`static Boolean[]`	`EMPTY_BOOLEAN_OBJECT_ARRAY` An empty immutable `Boolean` array.
`static byte[]`	`EMPTY_BYTE_ARRAY` An empty immutable `byte` array.
`static Byte[]`	`EMPTY_BYTE_OBJECT_ARRAY` An empty immutable `Byte` array.
`static char[]`	`EMPTY_CHAR_ARRAY` An empty immutable `char` array.
`static Character[]`	`EMPTY_CHARACTER_OBJECT_ARRAY` An empty immutable `Character` array.
`static Class[]`	`EMPTY_CLASS_ARRAY` An empty immutable `Class` array.
`static double[]`	`EMPTY_DOUBLE_ARRAY` An empty immutable `double` array.
`static Double[]`	`EMPTY_DOUBLE_OBJECT_ARRAY` An empty immutable `Double` array.
`static float[]`	`EMPTY_FLOAT_ARRAY` An empty immutable `float` array.
`static Float[]`	`EMPTY_FLOAT_OBJECT_ARRAY` An empty immutable `Float` array.
`static int[]`	`EMPTY_INT_ARRAY` An empty immutable `int` array.
`static Integer[]`	`EMPTY_INTEGER_OBJECT_ARRAY` An empty immutable `Integer` array.
`static long[]`	`EMPTY_LONG_ARRAY` An empty immutable `long` array.
`static Long[]`	`EMPTY_LONG_OBJECT_ARRAY` An empty immutable `Long` array.
`static Object[]`	`EMPTY_OBJECT_ARRAY` An empty immutable `Object` array.
`static short[]`	`EMPTY_SHORT_ARRAY` An empty immutable `short` array.
`static Short[]`	`EMPTY_SHORT_OBJECT_ARRAY` An empty immutable `Short` array.
`static String[]`	`EMPTY_STRING_ARRAY` An empty immutable `String` array.

Constructor Summary
`ArrayUtils()` ArrayUtils instances should NOT be constructed in standard programming.

Method Summary
`static boolean[]`	`clone(boolean[] array)` Clones an array returning a typecast result and handling `null`.
`static byte[]`	`clone(byte[] array)` Clones an array returning a typecast result and handling `null`.
`static char[]`	`clone(char[] array)` Clones an array returning a typecast result and handling `null`.
`static double[]`	`clone(double[] array)` Clones an array returning a typecast result and handling `null`.
`static float[]`	`clone(float[] array)` Clones an array returning a typecast result and handling `null`.
`static int[]`	`clone(int[] array)` Clones an array returning a typecast result and handling `null`.
`static long[]`	`clone(long[] array)` Clones an array returning a typecast result and handling `null`.
`static Object[]`	`clone(Object[] array)` Shallow clones an array returning a typecast result and handling `null`.
`static short[]`	`clone(short[] array)` Clones an array returning a typecast result and handling `null`.
`static boolean`	`contains(boolean[] array, boolean valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(byte[] array, byte valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(double[] array, double valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(double[] array, double valueToFind, double tolerance)` Checks if a value falling within the given tolerance is in the given array.
`static boolean`	`contains(float[] array, float valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(int[] array, int valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(long[] array, long valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(Object[] array, Object objectToFind)` Checks if the object is in the given array.
`static boolean`	`contains(short[] array, short valueToFind)` Checks if the value is in the given array.
`static int`	`hashCode(Object array)` Get a hashCode for an array handling multi-dimensional arrays correctly.
`static int`	`indexOf(boolean[] array, boolean valueToFind)` Find the index of the given value in the array.
`static int`	`indexOf(boolean[] array, boolean valueToFind, int startIndex)` Find the index of the given value in the array starting at the given index.
`static int`	`indexOf(byte[] array, byte valueToFind)` Find the index of the given value in the array.
`static int`	`indexOf(byte[] array, byte valueToFind, int startIndex)` Find the index of the given value in the array starting at the given index.
`static int`	`indexOf(double[] array, double valueToFind)` Find the index of the given value in the array.
`static int`	`indexOf(double[] array, double valueToFind, double tolerance)` Find the index of the given value within a given tolerance in the array.
`static int`	`indexOf(double[] array, double valueToFind, int startIndex)` Find the index of the given value in the array starting at the given index.
`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.
`static int`	`indexOf(float[] array, float valueToFind)` Find the index of the given value in the array.
`static int`	`indexOf(float[] array, float valueToFind, int startIndex)` Find the index of the given value in the array starting at the given index.
`static int`	`indexOf(int[] array, int valueToFind)` Find the index of the given value in the array.
`static int`	`indexOf(int[] array, int valueToFind, int startIndex)` Find the index of the given value in the array starting at the given index.
`static int`	`indexOf(long[] array, long valueToFind)` Find the index of the given value in the array.
`static int`	`indexOf(long[] array, long valueToFind, int startIndex)` Find the index of the given value in the array starting at the given index.
`static int`	`indexOf(Object[] array, Object objectToFind)` Find the index of the given object in the array.
`static int`	`indexOf(Object[] array, Object objectToFind, int startIndex)` Find the index of the given object in the array starting at the given index.
`static int`	`indexOf(short[] array, short valueToFind)` Find the index of the given value in the array.
`static int`	`indexOf(short[] array, short valueToFind, int startIndex)` Find the index of the given value in the array starting at the given index.
`static boolean`	`isEquals(Object array1, Object array2)` Compares two arrays, using equals(), handling multi-dimensional arrays correctly.
`static boolean`	`isSameLength(boolean[] array1, boolean[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0`.
`static boolean`	`isSameLength(byte[] array1, byte[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0`.
`static boolean`	`isSameLength(char[] array1, char[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0`.
`static boolean`	`isSameLength(double[] array1, double[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0`.
`static boolean`	`isSameLength(float[] array1, float[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0`.
`static boolean`	`isSameLength(int[] array1, int[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0`.
`static boolean`	`isSameLength(long[] array1, long[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0`.
`static boolean`	`isSameLength(Object[] array1, Object[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0`.
`static boolean`	`isSameLength(short[] array1, short[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0`.
`static boolean`	`isSameType(Object array1, Object array2)` Checks whether two arrays are the same type taking into account multi-dimensional arrays.
`static int`	`lastIndexOf(boolean[] array, boolean valueToFind)` Find the last index of the given value within the array.
`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.
`static int`	`lastIndexOf(byte[] array, byte valueToFind)` Find the last index of the given value within the array.
`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.
`static int`	`lastIndexOf(double[] array, double valueToFind)` Find the last index of the given value within the array.
`static int`	`lastIndexOf(double[] array, double valueToFind, double tolerance)` Find the last index of the given value within a given tolerance in the array.
`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.
`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.
`static int`	`lastIndexOf(float[] array, float valueToFind)` Find the last index of the given value within the array.
`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.
`static int`	`lastIndexOf(int[] array, int valueToFind)` Find the last index of the given value within the array.
`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.
`static int`	`lastIndexOf(long[] array, long valueToFind)` Find the last index of the given value within the array.
`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.
`static int`	`lastIndexOf(Object[] array, Object objectToFind)` Find the last index of the given object within the array.
`static int`	`lastIndexOf(Object[] array, Object objectToFind, int startIndex)` Find the last index of the given object in the array starting at the given index.
`static int`	`lastIndexOf(short[] array, short valueToFind)` Find the last index of the given value within the array.
`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.
`static void`	`reverse(boolean[] array)` Reverses the order of the given array.
`static void`	`reverse(byte[] array)` Reverses the order of the given array.
`static void`	`reverse(char[] array)` Reverses the order of the given array.
`static void`	`reverse(double[] array)` Reverses the order of the given array.
`static void`	`reverse(float[] array)` Reverses the order of the given array.
`static void`	`reverse(int[] array)` Reverses the order of the given array.
`static void`	`reverse(long[] array)` Reverses the order of the given array.
`static void`	`reverse(Object[] array)` Reverses the order of the given array.
`static void`	`reverse(short[] array)` Reverses the order of the given array.
`static Map`	`toMap(Object[] array)` Converts the given array into a `Map`.
`static Boolean[]`	`toObject(boolean[] array)` Converts an array of primitive booleans to objects.
`static Byte[]`	`toObject(byte[] array)` Converts an array of primitive bytes to objects.
`static Double[]`	`toObject(double[] array)` Converts an array of primitive doubles to objects.
`static Float[]`	`toObject(float[] array)` Converts an array of primitive floats to objects.
`static Integer[]`	`toObject(int[] array)` Converts an array of primitive ints to objects.
`static Long[]`	`toObject(long[] array)` Converts an array of primitive longs to objects.
`static Short[]`	`toObject(short[] array)` Converts an array of primitive shorts to objects.
`static boolean[]`	`toPrimitive(Boolean[] array)` Converts an array of object Booleans to primitives.
`static boolean[]`	`toPrimitive(Boolean[] array, boolean valueForNull)` Converts an array of object Booleans to primitives handling `null`.
`static byte[]`	`toPrimitive(Byte[] array)` Converts an array of object Bytes to primitives.
`static byte[]`	`toPrimitive(Byte[] array, byte valueForNull)` Converts an array of object Bytes to primitives handling `null`.
`static double[]`	`toPrimitive(Double[] array)` Converts an array of object Doubles to primitives.
`static double[]`	`toPrimitive(Double[] array, double valueForNull)` Converts an array of object Doubles to primitives handling `null`.
`static float[]`	`toPrimitive(Float[] array)` Converts an array of object Floats to primitives.
`static float[]`	`toPrimitive(Float[] array, float valueForNull)` Converts an array of object Floats to primitives handling `null`.
`static int[]`	`toPrimitive(Integer[] array)` Converts an array of object Integers to primitives.
`static int[]`	`toPrimitive(Integer[] array, int valueForNull)` Converts an array of object Integer to primitives handling `null`.
`static long[]`	`toPrimitive(Long[] array)` Converts an array of object Longs to primitives.
`static long[]`	`toPrimitive(Long[] array, long valueForNull)` Converts an array of object Long to primitives handling `null`.
`static short[]`	`toPrimitive(Short[] array)` Converts an array of object Shorts to primitives.
`static short[]`	`toPrimitive(Short[] array, short valueForNull)` Converts an array of object Short to primitives handling `null`.
`static String`	`toString(Object array)` Outputs an array as a String, treating `null` as an empty array.
`static String`	`toString(Object array, String stringIfNull)` Outputs an array as a String handling `null`s.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_OBJECT_ARRAY

public static final Object[] EMPTY_OBJECT_ARRAY

An empty immutable Object array.

EMPTY_CLASS_ARRAY

public static final Class[] EMPTY_CLASS_ARRAY

An empty immutable Class array.

EMPTY_STRING_ARRAY

public static final String[] EMPTY_STRING_ARRAY

An empty immutable String array.

EMPTY_LONG_ARRAY

public static final long[] EMPTY_LONG_ARRAY

An empty immutable long array.

EMPTY_LONG_OBJECT_ARRAY

public static final Long[] EMPTY_LONG_OBJECT_ARRAY

An empty immutable Long array.

EMPTY_INT_ARRAY

public static final int[] EMPTY_INT_ARRAY

An empty immutable int array.

EMPTY_INTEGER_OBJECT_ARRAY

public static final Integer[] EMPTY_INTEGER_OBJECT_ARRAY

An empty immutable Integer array.

EMPTY_SHORT_ARRAY

public static final short[] EMPTY_SHORT_ARRAY

An empty immutable short array.

EMPTY_SHORT_OBJECT_ARRAY

public static final Short[] EMPTY_SHORT_OBJECT_ARRAY

An empty immutable Short array.

EMPTY_BYTE_ARRAY

public static final byte[] EMPTY_BYTE_ARRAY

An empty immutable byte array.

EMPTY_BYTE_OBJECT_ARRAY

public static final Byte[] EMPTY_BYTE_OBJECT_ARRAY

An empty immutable Byte array.

EMPTY_DOUBLE_ARRAY

public static final double[] EMPTY_DOUBLE_ARRAY

An empty immutable double array.

EMPTY_DOUBLE_OBJECT_ARRAY

public static final Double[] EMPTY_DOUBLE_OBJECT_ARRAY

An empty immutable Double array.

EMPTY_FLOAT_ARRAY

public static final float[] EMPTY_FLOAT_ARRAY

An empty immutable float array.

EMPTY_FLOAT_OBJECT_ARRAY

public static final Float[] EMPTY_FLOAT_OBJECT_ARRAY

An empty immutable Float array.

EMPTY_BOOLEAN_ARRAY

public static final boolean[] EMPTY_BOOLEAN_ARRAY

An empty immutable boolean array.

EMPTY_BOOLEAN_OBJECT_ARRAY

public static final Boolean[] EMPTY_BOOLEAN_OBJECT_ARRAY

An empty immutable Boolean array.

EMPTY_CHAR_ARRAY

public static final char[] EMPTY_CHAR_ARRAY

An empty immutable char array.

EMPTY_CHARACTER_OBJECT_ARRAY

public static final Character[] EMPTY_CHARACTER_OBJECT_ARRAY

An empty immutable Character array.

Constructor Detail

ArrayUtils

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

toString

public static String toString(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:: array - the array to get a toString for, may be null
Returns:: a String representation of the array, '{}' if null array input

toString

public static String toString(Object array,
                              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:: array - the array to get a toString for, may be null; stringIfNull - the String to return if the array is null
Returns:: a String representation of the array

hashCode

public static int hashCode(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:: array - the array to get a hashCode for, may be null
Returns:: a hashCode for the array, zero if null array input

isEquals

public static boolean isEquals(Object array1,
                               Object array2)

Compares two arrays, using equals(), handling multi-dimensional arrays correctly.

Multi-dimensional primitive arrays are also handled correctly by this method.

Parameters:: array1 - the array to get a hashCode for, may be null; array2 - the array to get a hashCode for, may be null
Returns:: true if the arrays are equal

toMap

public static Map toMap(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:: array - an 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:: IllegalArgumentException - if one element of this Array is itself an Array containing less then two elements; IllegalArgumentException - if the array contains elements other than Map.Entry and an Array

clone

public static Object[] clone(Object[] array)

Shallow clones an array returning a typecast result and handling null.

The objecs 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:: array - the array to shallow clone, may be null
Returns:: the cloned array, null if null input

clone

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:: array - the array to clone, may be null
Returns:: the cloned array, null if null input

clone

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:: array - the array to clone, may be null
Returns:: the cloned array, null if null input

clone

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:: array - the array to clone, may be null
Returns:: the cloned array, null if null input

clone

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:: array - the array to clone, may be null
Returns:: the cloned array, null if null input

clone

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:: array - the array to clone, may be null
Returns:: the cloned array, null if null input

clone

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:: array - the array to clone, may be null
Returns:: the cloned array, null if null input

clone

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:: array - the array to clone, may be null
Returns:: the cloned array, null if null input

clone

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:: array - the array to clone, may be null
Returns:: the cloned array, null if null input

isSameLength

public static boolean isSameLength(Object[] array1,
                                   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:: array1 - the first array, may be null; array2 - the second array, may be null
Returns:: true if length of arrays matches, treating null as an empty array

isSameLength

public static boolean isSameLength(long[] array1,
                                   long[] array2)

Checks whether two arrays are the same length, treating null arrays as length 0.

Parameters:: array1 - the first array, may be null; array2 - the second array, may be null
Returns:: true if length of arrays matches, treating null as an empty array

isSameLength

public static boolean isSameLength(int[] array1,
                                   int[] array2)

Checks whether two arrays are the same length, treating null arrays as length 0.

Parameters:: array1 - the first array, may be null; array2 - the second array, may be null
Returns:: true if length of arrays matches, treating null as an empty array

isSameLength

public static boolean isSameLength(short[] array1,
                                   short[] array2)

Checks whether two arrays are the same length, treating null arrays as length 0.

Parameters:: array1 - the first array, may be null; array2 - the second array, may be null
Returns:: true if length of arrays matches, treating null as an empty array

isSameLength

public static boolean isSameLength(char[] array1,
                                   char[] array2)

Checks whether two arrays are the same length, treating null arrays as length 0.

Parameters:: array1 - the first array, may be null; array2 - the second array, may be null
Returns:: true if length of arrays matches, treating null as an empty array

isSameLength

public static boolean isSameLength(byte[] array1,
                                   byte[] array2)

Checks whether two arrays are the same length, treating null arrays as length 0.

Parameters:: array1 - the first array, may be null; array2 - the second array, may be null
Returns:: true if length of arrays matches, treating null as an empty array

isSameLength

public static boolean isSameLength(double[] array1,
                                   double[] array2)

Checks whether two arrays are the same length, treating null arrays as length 0.

Parameters:: array1 - the first array, may be null; array2 - the second array, may be null
Returns:: true if length of arrays matches, treating null as an empty array

isSameLength

public static boolean isSameLength(float[] array1,
                                   float[] array2)

Checks whether two arrays are the same length, treating null arrays as length 0.

Parameters:: array1 - the first array, may be null; array2 - the second array, may be null
Returns:: true if length of arrays matches, treating null as an empty array

isSameLength

public static boolean isSameLength(boolean[] array1,
                                   boolean[] array2)

Checks whether two arrays are the same length, treating null arrays as length 0.

Parameters:: array1 - the first array, may be null; array2 - the second array, may be null
Returns:: true if length of arrays matches, treating null as an empty array

isSameType

public static boolean isSameType(Object array1,
                                 Object array2)

Checks whether two arrays are the same type taking into account multi-dimensional arrays.

Parameters:: array1 - the first array, must not be null; array2 - the second array, must not be null
Returns:: true if type of arrays matches
Throws:: IllegalArgumentException - if either array is null

reverse

public static void reverse(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:: array - the array to reverse, may be null

reverse

public static void reverse(long[] array)

Reverses the order of the given array.

This method does nothing if null array input.

Parameters:: array - the array to reverse, may be null

reverse

public static void reverse(int[] array)

Reverses the order of the given array.

This method does nothing if null array input.

Parameters:: array - the array to reverse, may be null

reverse

public static void reverse(short[] array)

Reverses the order of the given array.

This method does nothing if null array input.

Parameters:: array - the array to reverse, may be null

reverse

public static void reverse(char[] array)

Reverses the order of the given array.

This method does nothing if null array input.

Parameters:: array - the array to reverse, may be null

reverse

public static void reverse(byte[] array)

Reverses the order of the given array.

This method does nothing if null array input.

Parameters:: array - the array to reverse, may be null

reverse

public static void reverse(double[] array)

Reverses the order of the given array.

This method does nothing if null array input.

Parameters:: array - the array to reverse, may be null

reverse

public static void reverse(float[] array)

Reverses the order of the given array.

This method does nothing if null array input.

Parameters:: array - the array to reverse, may be null

reverse

public static void reverse(boolean[] array)

Reverses the order of the given array.

This method does nothing if null array input.

Parameters:: array - the array to reverse, may be null

indexOf

public static int indexOf(Object[] array,
                          Object objectToFind)

Find the index of the given object in the array.

This method returns -1 if null array input.

Parameters:: array - the array to search through for the object, may be null; objectToFind - the object to find, may be null
Returns:: the index of the object within the array, -1 if not found or null array input

indexOf

public static int indexOf(Object[] array,
                          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:: array - the array to search through for the object, may be null; objectToFind - the object to find, may be null; startIndex - the 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

lastIndexOf

public static int lastIndexOf(Object[] array,
                              Object objectToFind)

Find the last index of the given object within the array.

This method returns -1 if null array input.

Parameters:: array - the array to travers backwords looking for the object, may be null; objectToFind - the object to find, may be null
Returns:: the last index of the object within the array, -1 if not found or null array input

lastIndexOf

public static int lastIndexOf(Object[] array,
                              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:: array - the array to traverse for looking for the object, may be null; objectToFind - the object to find, may be null; startIndex - the start index to travers backwards from
Returns:: the last index of the object within the array, -1 if not found or null array input

contains

public static boolean contains(Object[] array,
                               Object objectToFind)

Checks if the object is in the given array.

The method returns false if a null array is passed in.

Parameters:: array - the array to search through; objectToFind - the object to find
Returns:: true if the array contains the object

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find
Returns:: the index of the value within the array, -1 if not found or null array input

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find; startIndex - the index to start searching at
Returns:: the index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to travers backwords looking for the object, may be null; valueToFind - the object to find
Returns:: the last index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to traverse for looking for the object, may be null; valueToFind - the value to find; startIndex - the start index to travers backwards from
Returns:: the last index of the value within the array, -1 if not found or null array input

contains

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:: array - the array to search through; valueToFind - the value to find
Returns:: true if the array contains the object

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find
Returns:: the index of the value within the array, -1 if not found or null array input

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find; startIndex - the index to start searching at
Returns:: the index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to travers backwords looking for the object, may be null; valueToFind - the object to find
Returns:: the last index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to traverse for looking for the object, may be null; valueToFind - the value to find; startIndex - the start index to travers backwards from
Returns:: the last index of the value within the array, -1 if not found or null array input

contains

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:: array - the array to search through; valueToFind - the value to find
Returns:: true if the array contains the object

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find
Returns:: the index of the value within the array, -1 if not found or null array input

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find; startIndex - the index to start searching at
Returns:: the index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to travers backwords looking for the object, may be null; valueToFind - the object to find
Returns:: the last index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to traverse for looking for the object, may be null; valueToFind - the value to find; startIndex - the start index to travers backwards from
Returns:: the last index of the value within the array, -1 if not found or null array input

contains

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:: array - the array to search through; valueToFind - the value to find
Returns:: true if the array contains the object

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find
Returns:: the index of the value within the array, -1 if not found or null array input

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find; startIndex - the index to start searching at
Returns:: the index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to travers backwords looking for the object, may be null; valueToFind - the object to find
Returns:: the last index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to traverse for looking for the object, may be null; valueToFind - the value to find; startIndex - the start index to travers backwards from
Returns:: the last index of the value within the array, -1 if not found or null array input

contains

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:: array - the array to search through; valueToFind - the value to find
Returns:: true if the array contains the object

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find
Returns:: the index of the value within the array, -1 if not found or null array input

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find; tolerance - tolerance of the search
Returns:: the index of the value within the array, -1 if not found or null array input

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find; startIndex - the index to start searching at
Returns:: the index of the value within the array, -1 if not found or null array input

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find; startIndex - the index to start searching at; tolerance - tolerance of the search
Returns:: the index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to travers backwords looking for the object, may be null; valueToFind - the object to find
Returns:: the last index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find; tolerance - tolerance of the search
Returns:: the index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to traverse for looking for the object, may be null; valueToFind - the value to find; startIndex - the start index to travers backwards from
Returns:: the last index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to traverse for looking for the object, may be null; valueToFind - the value to find; startIndex - the start index to travers backwards from; tolerance - search 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

contains

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:: array - the array to search through; valueToFind - the value to find
Returns:: true if the array contains the object

contains

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:: array - the array to search; valueToFind - the value to find; tolerance - the array contains the tolerance of the search
Returns:: true if value falling within tolerance is in array

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find
Returns:: the index of the value within the array, -1 if not found or null array input

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find; startIndex - the index to start searching at
Returns:: the index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to travers backwords looking for the object, may be null; valueToFind - the object to find
Returns:: the last index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to traverse for looking for the object, may be null; valueToFind - the value to find; startIndex - the start index to travers backwards from
Returns:: the last index of the value within the array, -1 if not found or null array input

contains

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:: array - the array to search through; valueToFind - the value to find
Returns:: true if the array contains the object

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find
Returns:: the index of the value within the array, -1 if not found or null array input

indexOf

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:: array - the array to search through for the object, may be null; valueToFind - the value to find; startIndex - the index to start searching at
Returns:: the index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to travers backwords looking for the object, may be null; valueToFind - the object to find
Returns:: the last index of the value within the array, -1 if not found or null array input

lastIndexOf

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:: array - the array to traverse for looking for the object, may be null; valueToFind - the value to find; startIndex - the start index to travers backwards from
Returns:: the last index of the value within the array, -1 if not found or null array input

contains

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:: array - the array to search through; valueToFind - the value to find
Returns:: true if the array contains the object

toPrimitive

public static long[] toPrimitive(Long[] array)

Converts an array of object Longs to primitives.

This method returns null if null array input.

Parameters:: array - a Long array, may be null
Returns:: a long array, null if null array input
Throws:: NullPointerException - if array content is null

toPrimitive

public static long[] toPrimitive(Long[] array,
                                 long valueForNull)

Converts an array of object Long to primitives handling null.

This method returns null if null array input.

Parameters:: array - a Long array, may be null; valueForNull - the value to insert if null found
Returns:: a long array, null if null array input

toObject

public static Long[] toObject(long[] array)

Converts an array of primitive longs to objects.

This method returns null if null array input.

Parameters:: array - a long array
Returns:: a Long array, null if null array input

toPrimitive

public static int[] toPrimitive(Integer[] array)

Converts an array of object Integers to primitives.

This method returns null if null array input.

Parameters:: array - a Integer array, may be null
Returns:: an int array, null if null array input
Throws:: NullPointerException - if array content is null

toPrimitive

public static int[] toPrimitive(Integer[] array,
                                int valueForNull)

Converts an array of object Integer to primitives handling null.

This method returns null if null array input.

Parameters:: array - a Integer array, may be null; valueForNull - the value to insert if null found
Returns:: an int array, null if null array input

toObject

public static Integer[] toObject(int[] array)

Converts an array of primitive ints to objects.

This method returns null if null array input.

Parameters:: array - an int array
Returns:: an Integer array, null if null array input

toPrimitive

public static short[] toPrimitive(Short[] array)

Converts an array of object Shorts to primitives.

This method returns null if null array input.

Parameters:: array - a Short array, may be null
Returns:: a byte array, null if null array input
Throws:: NullPointerException - if array content is null

toPrimitive

public static short[] toPrimitive(Short[] array,
                                  short valueForNull)

Converts an array of object Short to primitives handling null.

This method returns null if null array input.

Parameters:: array - a Short array, may be null; valueForNull - the value to insert if null found
Returns:: a byte array, null if null array input

toObject

public static Short[] toObject(short[] array)

Converts an array of primitive shorts to objects.

This method returns null if null array input.

Parameters:: array - a short array
Returns:: a Short array, null if null array input

toPrimitive

public static byte[] toPrimitive(Byte[] array)

Converts an array of object Bytes to primitives.

This method returns null if null array input.

Parameters:: array - a Byte array, may be null
Returns:: a byte array, null if null array input
Throws:: NullPointerException - if array content is null

toPrimitive

public static byte[] toPrimitive(Byte[] array,
                                 byte valueForNull)

Converts an array of object Bytes to primitives handling null.

This method returns null if null array input.

Parameters:: array - a Byte array, may be null; valueForNull - the value to insert if null found
Returns:: a byte array, null if null array input

toObject

public static Byte[] toObject(byte[] array)

Converts an array of primitive bytes to objects.

This method returns null if null array input.

Parameters:: array - a byte array
Returns:: a Byte array, null if null array input

toPrimitive

public static double[] toPrimitive(Double[] array)

Converts an array of object Doubles to primitives.

This method returns null if null array input.

Parameters:: array - a Double array, may be null
Returns:: a double array, null if null array input
Throws:: NullPointerException - if array content is null

toPrimitive

public static double[] toPrimitive(Double[] array,
                                   double valueForNull)

Converts an array of object Doubles to primitives handling null.

This method returns null if null array input.

Parameters:: array - a Double array, may be null; valueForNull - the value to insert if null found
Returns:: a double array, null if null array input

toObject

public static Double[] toObject(double[] array)

Converts an array of primitive doubles to objects.

This method returns null if null array input.

Parameters:: array - a double array
Returns:: a Double array, null if null array input

toPrimitive

public static float[] toPrimitive(Float[] array)

Converts an array of object Floats to primitives.

This method returns null if null array input.

Parameters:: array - a Float array, may be null
Returns:: a float array, null if null array input
Throws:: NullPointerException - if array content is null

toPrimitive

public static float[] toPrimitive(Float[] array,
                                  float valueForNull)

Converts an array of object Floats to primitives handling null.

This method returns null if null array input.

Parameters:: array - a Float array, may be null; valueForNull - the value to insert if null found
Returns:: a float array, null if null array input

toObject

public static Float[] toObject(float[] array)

Converts an array of primitive floats to objects.

This method returns null if null array input.

Parameters:: array - a float array
Returns:: a Float array, null if null array input

toPrimitive

public static boolean[] toPrimitive(Boolean[] array)

Converts an array of object Booleans to primitives.

This method returns null if null array input.

Parameters:: array - a Boolean array, may be null
Returns:: a boolean array, null if null array input
Throws:: NullPointerException - if array content is null

toPrimitive

public static boolean[] toPrimitive(Boolean[] array,
                                    boolean valueForNull)

Converts an array of object Booleans to primitives handling null.

This method returns null if null array input.

Parameters:: array - a Boolean array, may be null; valueForNull - the value to insert if null found
Returns:: a boolean array, null if null array input

toObject

public static Boolean[] toObject(boolean[] array)

Converts an array of primitive booleans to objects.

This method returns null if null array input.

Parameters:: array - a boolean array
Returns:: a Boolean array, null if null array input

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.commons.lang Class ArrayUtils

EMPTY_OBJECT_ARRAY

EMPTY_CLASS_ARRAY

EMPTY_STRING_ARRAY

EMPTY_LONG_ARRAY

EMPTY_LONG_OBJECT_ARRAY

EMPTY_INT_ARRAY

EMPTY_INTEGER_OBJECT_ARRAY

EMPTY_SHORT_ARRAY

EMPTY_SHORT_OBJECT_ARRAY

EMPTY_BYTE_ARRAY

EMPTY_BYTE_OBJECT_ARRAY

EMPTY_DOUBLE_ARRAY

EMPTY_DOUBLE_OBJECT_ARRAY

EMPTY_FLOAT_ARRAY

EMPTY_FLOAT_OBJECT_ARRAY

EMPTY_BOOLEAN_ARRAY

EMPTY_BOOLEAN_OBJECT_ARRAY

EMPTY_CHAR_ARRAY

EMPTY_CHARACTER_OBJECT_ARRAY

ArrayUtils

toString

toString

hashCode

isEquals

toMap

clone

clone

clone

clone

clone

clone

clone

clone

clone

isSameLength

isSameLength

isSameLength

isSameLength

isSameLength

isSameLength

isSameLength

isSameLength

isSameLength

isSameType

reverse

reverse

reverse

reverse

reverse

reverse

reverse

reverse

reverse

indexOf

indexOf

lastIndexOf

lastIndexOf

contains

indexOf

indexOf

lastIndexOf

lastIndexOf

contains

indexOf

indexOf

lastIndexOf

lastIndexOf

contains

indexOf

indexOf

lastIndexOf

lastIndexOf

contains

indexOf

indexOf

lastIndexOf

lastIndexOf

contains

indexOf

org.apache.commons.lang
Class ArrayUtils