Class 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 behaviour.
Package private, might move to an internal package if this needs to be public.
#ThreadSafe#
- Since:
- 4.2 (Copied from Apache Commons Lang.)
-
Field Summary
FieldsModifier and TypeFieldDescription(package private) static final int
The index value when an element is not found in a list or array:-1
. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescription(package private) static boolean
Checks if the object is in the given array.(package private) static int
Finds the index of the given object in the array starting at the given index.(package private) static <T> int
Finds the index of the given object in the array.
-
Field Details
-
INDEX_NOT_FOUND
static final int INDEX_NOT_FOUNDThe index value when an element is not found in a list or array:-1
. This value is returned by methods in this class and can also be used in comparisons with values returned by various method fromList
.- See Also:
-
-
Constructor Details
-
ArrayUtils
ArrayUtils()
-
-
Method Details
-
contains
Checks if the object is in the given array.
The method returns
false
if anull
array is passed in.- Parameters:
array
- the array to search throughobjectToFind
- the object to find- Returns:
true
if the array contains the object
-
indexOf
Finds the index of the given object in the array.
This method returns
INDEX_NOT_FOUND
(-1
) for anull
input array.- Parameters:
array
- the array to search through for the object, may benull
objectToFind
- the object to find, may benull
- Returns:
- the index of the object within the array,
INDEX_NOT_FOUND
(-1
) if not found ornull
array input
-
indexOf
Finds the index of the given object in the array starting at the given index.
This method returns
INDEX_NOT_FOUND
(-1
) for anull
input array.A negative startIndex is treated as zero. A startIndex larger than the array length will return
INDEX_NOT_FOUND
(-1
).- Parameters:
array
- the array to search through for the object, may benull
objectToFind
- the object to find, may benull
startIndex
- the index to start searching at- Returns:
- the index of the object within the array starting at the index,
INDEX_NOT_FOUND
(-1
) if not found ornull
array input
-