Java Doc for ArrayUtils.java in  » Library » Apache-common-lang » org » apache » commons » lang » Java Source Code / Java DocumentationJava Source Code and Java Documentation

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.

ArrayUtils instances should NOT be constructed in standard programming.

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position.

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position.

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position.

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position.

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position.

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position.

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position.

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position.

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position.

Inserts the specified element at the specified position in the array.

Inserts the specified element at the specified position in the array.

Inserts the specified element at the specified position in the array.

Inserts the specified element at the specified position in the array.

Inserts the specified element at the specified position in the array.

Inserts the specified element at the specified position in the array.

Inserts the specified element at the specified position in the array.

Inserts the specified element at the specified position in the array.

Inserts the specified element at the specified position in the array.

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2.

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2.

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2.

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2.

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2.

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2.

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2.

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2.

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2.

Checks if a value falling within the given tolerance is in the given array.

Returns the length of the specified array.

Finds the index of the given object in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero.

Finds the index of the given value within a given tolerance in the array.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero.

Finds 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 ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero.

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

Finds the last index of the given object in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the last index of the given value within a given tolerance in the array.

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds 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 ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1).

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position.

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position.

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position.

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position.

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position.

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position.

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position.

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position.

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position.

Removes the first occurrence of the specified element from the specified array.

Removes the first occurrence of the specified element from the specified array.

Removes the first occurrence of the specified element from the specified array.

Removes the first occurrence of the specified element from the specified array.

Removes the first occurrence of the specified element from the specified array.

Removes the first occurrence of the specified element from the specified array.

Removes the first occurrence of the specified element from the specified array.

Removes the first occurrence of the specified element from the specified array.

Removes the first occurrence of the specified element from the specified array.

Produces a new array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.

The component type of the subarray is always the same as that of the input array.

Produces a new long array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.

Produces a new int array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.

Produces a new short array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.

Produces a new char array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.

Produces a new byte array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.

Produces a new double array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.

Produces a new float array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.

Produces a new boolean array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.

Converts the given array into a java.util.Map .

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.

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position. The component type of the new array is the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, null)      = [null]
 ArrayUtils.add(null, "a")       = ["a"]
 ArrayUtils.add(["a"], null)     = ["a", null]
 ArrayUtils.add(["a"], "b")      = ["a", "b"]
 ArrayUtils.add(["a", "b"], "c") = ["a", "b", "c"]
 

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position. The component type of the new array is the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, true)          = [true]
 ArrayUtils.add([true], false)       = [true, false]
 ArrayUtils.add([true, false], true) = [true, false, true]
 

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position. The component type of the new array is the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, 0)   = [0]
 ArrayUtils.add([1], 0)    = [1, 0]
 ArrayUtils.add([1, 0], 1) = [1, 0, 1]
 

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position. The component type of the new array is the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, '0')       = ['0']
 ArrayUtils.add(['1'], '0')      = ['1', '0']
 ArrayUtils.add(['1', '0'], '1') = ['1', '0', '1']
 

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position. The component type of the new array is the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, 0)   = [0]
 ArrayUtils.add([1], 0)    = [1, 0]
 ArrayUtils.add([1, 0], 1) = [1, 0, 1]
 

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position. The component type of the new array is the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, 0)   = [0]
 ArrayUtils.add([1], 0)    = [1, 0]
 ArrayUtils.add([1, 0], 1) = [1, 0, 1]
 

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position. The component type of the new array is the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, 0)   = [0]
 ArrayUtils.add([1], 0)    = [1, 0]
 ArrayUtils.add([1, 0], 1) = [1, 0, 1]
 

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position. The component type of the new array is the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, 0)   = [0]
 ArrayUtils.add([1], 0)    = [1, 0]
 ArrayUtils.add([1, 0], 1) = [1, 0, 1]
 

Copies the given array and adds the given element at the end of the new array.

The new array contains the same elements of the input array plus the given element in the last position. The component type of the new array is the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, 0)   = [0]
 ArrayUtils.add([1], 0)    = [1, 0]
 ArrayUtils.add([1, 0], 1) = [1, 0, 1]
 

Inserts the specified element at the specified position in the array. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

This method returns a new array with the same elements of the input array plus the given element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, 0, null)      = [null]
 ArrayUtils.add(null, 0, "a")       = ["a"]
 ArrayUtils.add(["a"], 1, null)     = ["a", null]
 ArrayUtils.add(["a"], 1, "b")      = ["a", "b"]
 ArrayUtils.add(["a", "b"], 3, "c") = ["a", "b", "c"]
 

Inserts the specified element at the specified position in the array. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

This method returns a new array with the same elements of the input array plus the given element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, 0, true)          = [true]
 ArrayUtils.add([true], 0, false)       = [false, true]
 ArrayUtils.add([false], 1, true)       = [false, true]
 ArrayUtils.add([true, false], 1, true) = [true, true, false]
 

Inserts the specified element at the specified position in the array. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

This method returns a new array with the same elements of the input array plus the given element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add(null, 0, 'a')            = ['a']
 ArrayUtils.add(['a'], 0, 'b')           = ['b', 'a']
 ArrayUtils.add(['a', 'b'], 0, 'c')      = ['c', 'a', 'b']
 ArrayUtils.add(['a', 'b'], 1, 'k')      = ['a', 'k', 'b']
 ArrayUtils.add(['a', 'b', 'c'], 1, 't') = ['a', 't', 'b', 'c']
 

Inserts the specified element at the specified position in the array. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

This method returns a new array with the same elements of the input array plus the given element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add([1], 0, 2)         = [2, 1]
 ArrayUtils.add([2, 6], 2, 3)      = [2, 6, 3]
 ArrayUtils.add([2, 6], 0, 1)      = [1, 2, 6]
 ArrayUtils.add([2, 6, 3], 2, 1)   = [2, 6, 1, 3]
 

Inserts the specified element at the specified position in the array. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

This method returns a new array with the same elements of the input array plus the given element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add([1], 0, 2)         = [2, 1]
 ArrayUtils.add([2, 6], 2, 10)     = [2, 6, 10]
 ArrayUtils.add([2, 6], 0, -4)     = [-4, 2, 6]
 ArrayUtils.add([2, 6, 3], 2, 1)   = [2, 6, 1, 3]
 

Inserts the specified element at the specified position in the array. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

This method returns a new array with the same elements of the input array plus the given element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add([1], 0, 2)         = [2, 1]
 ArrayUtils.add([2, 6], 2, 10)     = [2, 6, 10]
 ArrayUtils.add([2, 6], 0, -4)     = [-4, 2, 6]
 ArrayUtils.add([2, 6, 3], 2, 1)   = [2, 6, 1, 3]
 

Inserts the specified element at the specified position in the array. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

This method returns a new array with the same elements of the input array plus the given element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add([1L], 0, 2L)           = [2L, 1L]
 ArrayUtils.add([2L, 6L], 2, 10L)      = [2L, 6L, 10L]
 ArrayUtils.add([2L, 6L], 0, -4L)      = [-4L, 2L, 6L]
 ArrayUtils.add([2L, 6L, 3L], 2, 1L)   = [2L, 6L, 1L, 3L]
 

Inserts the specified element at the specified position in the array. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

This method returns a new array with the same elements of the input array plus the given element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add([1.1f], 0, 2.2f)               = [2.2f, 1.1f]
 ArrayUtils.add([2.3f, 6.4f], 2, 10.5f)        = [2.3f, 6.4f, 10.5f]
 ArrayUtils.add([2.6f, 6.7f], 0, -4.8f)        = [-4.8f, 2.6f, 6.7f]
 ArrayUtils.add([2.9f, 6.0f, 0.3f], 2, 1.0f)   = [2.9f, 6.0f, 1.0f, 0.3f]
 

Inserts the specified element at the specified position in the array. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

This method returns a new array with the same elements of the input array plus the given element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, a new one element array is returned whose component type is the same as the element.

 ArrayUtils.add([1.1], 0, 2.2)              = [2.2, 1.1]
 ArrayUtils.add([2.3, 6.4], 2, 10.5)        = [2.3, 6.4, 10.5]
 ArrayUtils.add([2.6, 6.7], 0, -4.8)        = [-4.8, 2.6, 6.7]
 ArrayUtils.add([2.9, 6.0, 0.3], 2, 1.0)    = [2.9, 6.0, 1.0, 0.3]
 

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2. When an array is returned, it is always a new array.

 ArrayUtils.addAll(null, null)     = null
 ArrayUtils.addAll(array1, null)   = cloned copy of array1
 ArrayUtils.addAll(null, array2)   = cloned copy of array2
 ArrayUtils.addAll([], [])         = []
 ArrayUtils.addAll([null], [null]) = [null, null]
 ArrayUtils.addAll(["a", "b", "c"], ["1", "2", "3"]) = ["a", "b", "c", "1", "2", "3"]
 

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2. When an array is returned, it is always a new array.

 ArrayUtils.addAll(array1, null)   = cloned copy of array1
 ArrayUtils.addAll(null, array2)   = cloned copy of array2
 ArrayUtils.addAll([], [])         = []
 

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2. When an array is returned, it is always a new array.

 ArrayUtils.addAll(array1, null)   = cloned copy of array1
 ArrayUtils.addAll(null, array2)   = cloned copy of array2
 ArrayUtils.addAll([], [])         = []
 

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2. When an array is returned, it is always a new array.

 ArrayUtils.addAll(array1, null)   = cloned copy of array1
 ArrayUtils.addAll(null, array2)   = cloned copy of array2
 ArrayUtils.addAll([], [])         = []
 

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2. When an array is returned, it is always a new array.

 ArrayUtils.addAll(array1, null)   = cloned copy of array1
 ArrayUtils.addAll(null, array2)   = cloned copy of array2
 ArrayUtils.addAll([], [])         = []
 

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2. When an array is returned, it is always a new array.

 ArrayUtils.addAll(array1, null)   = cloned copy of array1
 ArrayUtils.addAll(null, array2)   = cloned copy of array2
 ArrayUtils.addAll([], [])         = []
 

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2. When an array is returned, it is always a new array.

 ArrayUtils.addAll(array1, null)   = cloned copy of array1
 ArrayUtils.addAll(null, array2)   = cloned copy of array2
 ArrayUtils.addAll([], [])         = []
 

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2. When an array is returned, it is always a new array.

 ArrayUtils.addAll(array1, null)   = cloned copy of array1
 ArrayUtils.addAll(null, array2)   = cloned copy of array2
 ArrayUtils.addAll([], [])         = []
 

Adds all the elements of the given arrays into a new array.

The new array contains all of the element of array1 followed by all of the elements array2. When an array is returned, it is always a new array.

 ArrayUtils.addAll(array1, null)   = cloned copy of array1
 ArrayUtils.addAll(null, array2)   = cloned copy of array2
 ArrayUtils.addAll([], [])         = []
 

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 for a null input array.

Clones an array returning a typecast result and handling null.

This method returns null for a null input array.

Clones an array returning a typecast result and handling null.

This method returns null for a null input array.

Clones an array returning a typecast result and handling null.

This method returns null for a null input array.

Clones an array returning a typecast result and handling null.

This method returns null for a null input array.

Clones an array returning a typecast result and handling null.

This method returns null for a null input array.

Clones an array returning a typecast result and handling null.

This method returns null for a null input array.

Clones an array returning a typecast result and handling null.

This method returns null for a null input array.

Clones an array returning a typecast result and handling null.

This method returns null for a null input array.

Checks if the object is in the given array.

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

Checks if the value is in the given array.

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

Checks if the value is in the given array.

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

Checks if the value is in the given array.

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

Checks if the value is in the given array.

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

Checks if the value is in the given array.

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

Checks if the value is in the given array.

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

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.

Checks if the value is in the given array.

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

Checks if the value is in the given array.

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

Returns the length of the specified array. This method can deal with Object arrays and with primitive arrays.

If the input array is null, 0 is returned.

 ArrayUtils.getLength(null)            = 0
 ArrayUtils.getLength([])              = 0
 ArrayUtils.getLength([null])          = 1
 ArrayUtils.getLength([true, false])   = 2
 ArrayUtils.getLength([1, 2, 3])       = 3
 ArrayUtils.getLength(["a", "b", "c"]) = 3
 

Get a hashCode for an array handling multi-dimensional arrays correctly.

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

Finds the index of the given object in the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the index of the given object in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero. A startIndex larger than the array length will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the index of the given value in the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero. A startIndex larger than the array length will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the index of the given value in the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero. A startIndex larger than the array length will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the index of the given value in the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero. A startIndex larger than the array length will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the index of the given value in the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero. A startIndex larger than the array length will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the index of the given value in the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero. A startIndex larger than the array length will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the index of the given value in the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds 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 ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero. A startIndex larger than the array length will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds 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 ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero. A startIndex larger than the array length will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the index of the given value in the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero. A startIndex larger than the array length will return ArrayUtils.INDEX_NOT_FOUND (-1).

Finds the index of the given value in the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex is treated as zero. A startIndex larger than the array length will return ArrayUtils.INDEX_NOT_FOUND (-1).

Checks if an array of Objects is empty or null.

Checks if an array of primitive longs is empty or null.

Checks if an array of primitive ints is empty or null.

Checks if an array of primitive shorts is empty or null.

Checks if an array of primitive chars is empty or null.

Checks if an array of primitive bytes is empty or null.

Checks if an array of primitive doubles is empty or null.

Checks if an array of primitive floats is empty or null.

Checks if an array of primitive booleans is empty or null.

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

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

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

Any multi-dimensional aspects of the arrays are ignored.

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

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

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

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

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

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

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

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

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

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

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the last index of the given object in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.

Finds the last index of the given value within the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.

Finds the last index of the given value within the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.

Finds the last index of the given value within the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.

Finds the last index of the given value within the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.

Finds the last index of the given value within the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.

Finds the last index of the given value within the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds 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 ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.

Finds 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 ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.

Finds the last index of the given value within the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.

Finds the last index of the given value within the array.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) if null array input.

Finds the last index of the given value in the array starting at the given index.

This method returns ArrayUtils.INDEX_NOT_FOUND (-1) for a null input array.

A negative startIndex will return ArrayUtils.INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, an IndexOutOfBoundsException will be thrown, because in that case no valid index can be specified.

 ArrayUtils.remove(["a"], 0)           = []
 ArrayUtils.remove(["a", "b"], 0)      = ["b"]
 ArrayUtils.remove(["a", "b"], 1)      = ["a"]
 ArrayUtils.remove(["a", "b", "c"], 1) = ["a", "c"]
 

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, an IndexOutOfBoundsException will be thrown, because in that case no valid index can be specified.

 ArrayUtils.remove([true], 0)              = []
 ArrayUtils.remove([true, false], 0)       = [false]
 ArrayUtils.remove([true, false], 1)       = [true]
 ArrayUtils.remove([true, true, false], 1) = [true, false]
 

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, an IndexOutOfBoundsException will be thrown, because in that case no valid index can be specified.

 ArrayUtils.remove([1], 0)          = []
 ArrayUtils.remove([1, 0], 0)       = [0]
 ArrayUtils.remove([1, 0], 1)       = [1]
 ArrayUtils.remove([1, 0, 1], 1)    = [1, 1]
 

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, an IndexOutOfBoundsException will be thrown, because in that case no valid index can be specified.

 ArrayUtils.remove(['a'], 0)           = []
 ArrayUtils.remove(['a', 'b'], 0)      = ['b']
 ArrayUtils.remove(['a', 'b'], 1)      = ['a']
 ArrayUtils.remove(['a', 'b', 'c'], 1) = ['a', 'c']
 

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, an IndexOutOfBoundsException will be thrown, because in that case no valid index can be specified.

 ArrayUtils.remove([1.1], 0)           = []
 ArrayUtils.remove([2.5, 6.0], 0)      = [6.0]
 ArrayUtils.remove([2.5, 6.0], 1)      = [2.5]
 ArrayUtils.remove([2.5, 6.0, 3.8], 1) = [2.5, 3.8]
 

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, an IndexOutOfBoundsException will be thrown, because in that case no valid index can be specified.

 ArrayUtils.remove([1.1], 0)           = []
 ArrayUtils.remove([2.5, 6.0], 0)      = [6.0]
 ArrayUtils.remove([2.5, 6.0], 1)      = [2.5]
 ArrayUtils.remove([2.5, 6.0, 3.8], 1) = [2.5, 3.8]
 

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, an IndexOutOfBoundsException will be thrown, because in that case no valid index can be specified.

 ArrayUtils.remove([1], 0)         = []
 ArrayUtils.remove([2, 6], 0)      = [6]
 ArrayUtils.remove([2, 6], 1)      = [2]
 ArrayUtils.remove([2, 6, 3], 1)   = [2, 3]
 

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, an IndexOutOfBoundsException will be thrown, because in that case no valid index can be specified.

 ArrayUtils.remove([1], 0)         = []
 ArrayUtils.remove([2, 6], 0)      = [6]
 ArrayUtils.remove([2, 6], 1)      = [2]
 ArrayUtils.remove([2, 6, 3], 1)   = [2, 3]
 

Removes the element at the specified position from the specified array. All subsequent elements are shifted to the left (substracts one from their indices).

This method returns a new array with the same elements of the input array except the element on the specified position. The component type of the returned array is always the same as that of the input array.

If the input array is null, an IndexOutOfBoundsException will be thrown, because in that case no valid index can be specified.

 ArrayUtils.remove([1], 0)         = []
 ArrayUtils.remove([2, 6], 0)      = [6]
 ArrayUtils.remove([2, 6], 1)      = [2]
 ArrayUtils.remove([2, 6, 3], 1)   = [2, 3]
 

Removes the first occurrence of the specified element from the specified array. All subsequent elements are shifted to the left (substracts one from their indices). If the array doesn't contains such an element, no elements are removed from the array.

This method returns a new array with the same elements of the input array except the first occurrence of the specified element. The component type of the returned array is always the same as that of the input array.

 ArrayUtils.removeElement(null, "a")            = null
 ArrayUtils.removeElement([], "a")              = []
 ArrayUtils.removeElement(["a"], "b")           = ["a"]
 ArrayUtils.removeElement(["a", "b"], "a")      = ["b"]
 ArrayUtils.removeElement(["a", "b", "a"], "a") = ["b", "a"]
 

Removes the first occurrence of the specified element from the specified array. All subsequent elements are shifted to the left (substracts one from their indices). If the array doesn't contains such an element, no elements are removed from the array.

This method returns a new array with the same elements of the input array except the first occurrence of the specified element. The component type of the returned array is always the same as that of the input array.

 ArrayUtils.removeElement(null, true)                = null
 ArrayUtils.removeElement([], true)                  = []
 ArrayUtils.removeElement([true], false)             = [true]
 ArrayUtils.removeElement([true, false], false)      = [true]
 ArrayUtils.removeElement([true, false, true], true) = [false, true]
 

Removes the first occurrence of the specified element from the specified array. All subsequent elements are shifted to the left (substracts one from their indices). If the array doesn't contains such an element, no elements are removed from the array.

This method returns a new array with the same elements of the input array except the first occurrence of the specified element. The component type of the returned array is always the same as that of the input array.

 ArrayUtils.removeElement(null, 1)        = null
 ArrayUtils.removeElement([], 1)          = []
 ArrayUtils.removeElement([1], 0)         = [1]
 ArrayUtils.removeElement([1, 0], 0)      = [1]
 ArrayUtils.removeElement([1, 0, 1], 1)   = [0, 1]
 

Removes the first occurrence of the specified element from the specified array. All subsequent elements are shifted to the left (substracts one from their indices). If the array doesn't contains such an element, no elements are removed from the array.

This method returns a new array with the same elements of the input array except the first occurrence of the specified element. The component type of the returned array is always the same as that of the input array.

 ArrayUtils.removeElement(null, 'a')            = null
 ArrayUtils.removeElement([], 'a')              = []
 ArrayUtils.removeElement(['a'], 'b')           = ['a']
 ArrayUtils.removeElement(['a', 'b'], 'a')      = ['b']
 ArrayUtils.removeElement(['a', 'b', 'a'], 'a') = ['b', 'a']
 

Removes the first occurrence of the specified element from the specified array. All subsequent elements are shifted to the left (substracts one from their indices). If the array doesn't contains such an element, no elements are removed from the array.

This method returns a new array with the same elements of the input array except the first occurrence of the specified element. The component type of the returned array is always the same as that of the input array.

 ArrayUtils.removeElement(null, 1.1)            = null
 ArrayUtils.removeElement([], 1.1)              = []
 ArrayUtils.removeElement([1.1], 1.2)           = [1.1]
 ArrayUtils.removeElement([1.1, 2.3], 1.1)      = [2.3]
 ArrayUtils.removeElement([1.1, 2.3, 1.1], 1.1) = [2.3, 1.1]
 

Removes the first occurrence of the specified element from the specified array. All subsequent elements are shifted to the left (substracts one from their indices). If the array doesn't contains such an element, no elements are removed from the array.

This method returns a new array with the same elements of the input array except the first occurrence of the specified element. The component type of the returned array is always the same as that of the input array.

 ArrayUtils.removeElement(null, 1.1)            = null
 ArrayUtils.removeElement([], 1.1)              = []
 ArrayUtils.removeElement([1.1], 1.2)           = [1.1]
 ArrayUtils.removeElement([1.1, 2.3], 1.1)      = [2.3]
 ArrayUtils.removeElement([1.1, 2.3, 1.1], 1.1) = [2.3, 1.1]
 

Removes the first occurrence of the specified element from the specified array. All subsequent elements are shifted to the left (substracts one from their indices). If the array doesn't contains such an element, no elements are removed from the array.

This method returns a new array with the same elements of the input array except the first occurrence of the specified element. The component type of the returned array is always the same as that of the input array.

 ArrayUtils.removeElement(null, 1)      = null
 ArrayUtils.removeElement([], 1)        = []
 ArrayUtils.removeElement([1], 2)       = [1]
 ArrayUtils.removeElement([1, 3], 1)    = [3]
 ArrayUtils.removeElement([1, 3, 1], 1) = [3, 1]
 

Removes the first occurrence of the specified element from the specified array. All subsequent elements are shifted to the left (substracts one from their indices). If the array doesn't contains such an element, no elements are removed from the array.

This method returns a new array with the same elements of the input array except the first occurrence of the specified element. The component type of the returned array is always the same as that of the input array.

 ArrayUtils.removeElement(null, 1)      = null
 ArrayUtils.removeElement([], 1)        = []
 ArrayUtils.removeElement([1], 2)       = [1]
 ArrayUtils.removeElement([1, 3], 1)    = [3]
 ArrayUtils.removeElement([1, 3, 1], 1) = [3, 1]
 

Removes the first occurrence of the specified element from the specified array. All subsequent elements are shifted to the left (substracts one from their indices). If the array doesn't contains such an element, no elements are removed from the array.

This method returns a new array with the same elements of the input array except the first occurrence of the specified element. The component type of the returned array is always the same as that of the input array.

 ArrayUtils.removeElement(null, 1)      = null
 ArrayUtils.removeElement([], 1)        = []
 ArrayUtils.removeElement([1], 2)       = [1]
 ArrayUtils.removeElement([1, 3], 1)    = [3]
 ArrayUtils.removeElement([1, 3, 1], 1) = [3, 1]
 

Reverses the order of the given array.

There is no special handling for multi-dimensional arrays.

This method does nothing for a null input array.

Reverses the order of the given array.

This method does nothing for a null input array.

Reverses the order of the given array.

This method does nothing for a null input array.

Reverses the order of the given array.

This method does nothing for a null input array.

Reverses the order of the given array.

This method does nothing for a null input array.

Reverses the order of the given array.

This method does nothing for a null input array.

Reverses the order of the given array.

This method does nothing for a null input array.

Reverses the order of the given array.

This method does nothing for a null input array.

Reverses the order of the given array.

This method does nothing for a null input array.

Produces a new array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.

The component type of the subarray is always the same as that of the input array. Thus, if the input is an array of type Date, the following usage is envisaged:

 Date[] someDates = (Date[])ArrayUtils.subarray(allDates, 2, 5);
 

Produces a new long array containing the elements between the start and end indices.

The start index is inclusive, the end index exclusive. Null array input produces null output.