Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
java.lang.Object
org.apache.commons.lang.ArrayUtils
public class ArrayUtils
extends Object
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.
Field Summary | |
static boolean[] |
|
static Boolean[] |
|
static byte[] |
|
static Byte[] |
|
static Character[] |
|
static char[] |
|
static Class[] |
|
static double[] |
|
static Double[] |
|
static float[] |
|
static Float[] |
|
static Integer[] |
|
static int[] |
|
static long[] |
|
static Long[] |
|
static Object[] |
|
static short[] |
|
static Short[] |
|
static String[] |
|
Constructor Summary | |
|
Method Summary | |
static Object[] |
|
static Object[] |
|
static boolean[] |
|
static boolean[] |
|
static byte[] |
|
static byte[] |
|
static char[] |
|
static char[] |
|
static double[] |
|
static double[] |
|
static float[] |
|
static float[] |
|
static int[] |
|
static int[] |
|
static long[] |
|
static long[] |
|
static short[] |
|
static short[] |
|
static Object[] |
|
static boolean[] |
|
static byte[] |
|
static char[] |
|
static double[] |
|
static float[] |
|
static int[] |
|
static long[] |
|
static short[] |
|
static Object[] |
|
static boolean[] |
|
static byte[] |
|
static char[] |
|
static double[] |
|
static float[] |
|
static int[] |
|
static long[] |
|
static short[] |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static boolean |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static int |
|
static Object[] |
|
static boolean[] |
|
static byte[] |
|
static char[] |
|
static double[] |
|
static float[] |
|
static int[] |
|
static long[] |
|
static short[] |
|
static Object[] |
|
static boolean[] |
|
static byte[] |
|
static char[] |
|
static double[] |
|
static float[] |
|
static int[] |
|
static long[] |
|
static short[] |
|
static void |
|
static void |
|
static void |
|
static void |
|
static void |
|
static void |
|
static void |
|
static void |
|
static void |
|
static Object[] |
|
static boolean[] |
|
static byte[] |
|
static char[] |
|
static double[] |
|
static float[] |
|
static int[] |
|
static long[] |
|
static short[] |
|
static Map | |
static Boolean[] |
|
static Byte[] |
|
static Double[] |
|
static Float[] |
|
static Integer[] |
|
static Long[] |
|
static Short[] |
|
static boolean[] |
|
static boolean[] |
|
static byte[] |
|
static byte[] |
|
static double[] |
|
static double[] |
|
static float[] |
|
static float[] |
|
static int[] |
|
static int[] |
|
static long[] |
|
static long[] |
|
static short[] |
|
static short[] |
|
static String |
|
static String |
|
public static final boolean[] EMPTY_BOOLEAN_ARRAY
An empty immutableboolean
array.
public static final Boolean[] EMPTY_BOOLEAN_OBJECT_ARRAY
An empty immutableBoolean
array.
public static final byte[] EMPTY_BYTE_ARRAY
An empty immutablebyte
array.
public static final Byte[] EMPTY_BYTE_OBJECT_ARRAY
An empty immutableByte
array.
public static final Character[] EMPTY_CHARACTER_OBJECT_ARRAY
An empty immutableCharacter
array.
public static final char[] EMPTY_CHAR_ARRAY
An empty immutablechar
array.
public static final Class[] EMPTY_CLASS_ARRAY
An empty immutableClass
array.
public static final double[] EMPTY_DOUBLE_ARRAY
An empty immutabledouble
array.
public static final Double[] EMPTY_DOUBLE_OBJECT_ARRAY
An empty immutableDouble
array.
public static final float[] EMPTY_FLOAT_ARRAY
An empty immutablefloat
array.
public static final Float[] EMPTY_FLOAT_OBJECT_ARRAY
An empty immutableFloat
array.
public static final Integer[] EMPTY_INTEGER_OBJECT_ARRAY
An empty immutableInteger
array.
public static final int[] EMPTY_INT_ARRAY
An empty immutableint
array.
public static final long[] EMPTY_LONG_ARRAY
An empty immutablelong
array.
public static final Long[] EMPTY_LONG_OBJECT_ARRAY
An empty immutableLong
array.
public static final Object[] EMPTY_OBJECT_ARRAY
An empty immutableObject
array.
public static final short[] EMPTY_SHORT_ARRAY
An empty immutableshort
array.
public static final Short[] EMPTY_SHORT_OBJECT_ARRAY
An empty immutableShort
array.
public static final String[] EMPTY_STRING_ARRAY
An empty immutableString
array.
public ArrayUtils()
ArrayUtils instances should NOT be constructed in standard programming. Instead, the class should be used asArrayUtils.clone(new int[] {2})
. This constructor is public to permit tools that require a JavaBean instance to operate.
public static Object[] add(Object[] array, Object element)
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 isnull
, 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"]
- Parameters:
array
- the array to "add" the element to, may benull
element
- the object to add
- Returns:
- A new array containing the existing elements plus the new element
- Since:
- 2.1
public static Object[] add(Object[] array, int index, Object element)
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 isnull
, 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"]
- Parameters:
array
- the array to add the element to, may benull
index
- the position of the new objectelement
- the object to add
- Returns:
- A new array containing the existing elements and the new element
public static boolean[] add(boolean[] array, boolean element)
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 isnull
, 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]
- Parameters:
array
- the array to copy and add the element to, may benull
element
- the object to add at the last index of the new array
- Returns:
- A new array containing the existing elements plus the new element
- Since:
- 2.1
public static boolean[] add(boolean[] array, int index, boolean element)
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 isnull
, 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]
- Parameters:
array
- the array to add the element to, may benull
index
- the position of the new objectelement
- the object to add
- Returns:
- A new array containing the existing elements and the new element
public static byte[] add(byte[] array, byte element)
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 isnull
, 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]
- Parameters:
array
- the array to copy and add the element to, may benull
element
- the object to add at the last index of the new array
- Returns:
- A new array containing the existing elements plus the new element
- Since:
- 2.1
public static byte[] add(byte[] array, int index, byte element)
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 isnull
, 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]
- Parameters:
array
- the array to add the element to, may benull
index
- the position of the new objectelement
- the object to add
- Returns:
- A new array containing the existing elements and the new element
public static char[] add(char[] array, char element)
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 isnull
, 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']
- Parameters:
array
- the array to copy and add the element to, may benull
element
- the object to add at the last index of the new array
- Returns:
- A new array containing the existing elements plus the new element
- Since:
- 2.1
public static char[] add(char[] array, int index, char element)
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 isnull
, 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']
- Parameters:
array
- the array to add the element to, may benull
index
- the position of the new objectelement
- the object to add
- Returns:
- A new array containing the existing elements and the new element
public static double[] add(double[] array, double element)
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 isnull
, 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]
- Parameters:
array
- the array to copy and add the element to, may benull
element
- the object to add at the last index of the new array
- Returns:
- A new array containing the existing elements plus the new element
- Since:
- 2.1
public static double[] add(double[] array, int index, double element)
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 isnull
, 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]
- Parameters:
array
- the array to add the element to, may benull
index
- the position of the new objectelement
- the object to add
- Returns:
- A new array containing the existing elements and the new element
public static float[] add(float[] array, float element)
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 isnull
, 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]
- Parameters:
array
- the array to copy and add the element to, may benull
element
- the object to add at the last index of the new array
- Returns:
- A new array containing the existing elements plus the new element
- Since:
- 2.1
public static float[] add(float[] array, int index, float element)
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 isnull
, 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]
- Parameters:
array
- the array to add the element to, may benull
index
- the position of the new objectelement
- the object to add
- Returns:
- A new array containing the existing elements and the new element
public static int[] add(int[] array, int element)
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 isnull
, 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]
- Parameters:
array
- the array to copy and add the element to, may benull
element
- the object to add at the last index of the new array
- Returns:
- A new array containing the existing elements plus the new element
- Since:
- 2.1
public static int[] add(int[] array, int index, int element)
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 isnull
, 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]
- Parameters:
array
- the array to add the element to, may benull
index
- the position of the new objectelement
- the object to add
- Returns:
- A new array containing the existing elements and the new element
public static long[] add(long[] array, int index, long element)
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 isnull
, 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]
- Parameters:
array
- the array to add the element to, may benull
index
- the position of the new objectelement
- the object to add
- Returns:
- A new array containing the existing elements and the new element
public static long[] add(long[] array, long element)
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 isnull
, 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]
- Parameters:
array
- the array to copy and add the element to, may benull
element
- the object to add at the last index of the new array
- Returns:
- A new array containing the existing elements plus the new element
- Since:
- 2.1
public static short[] add(short[] array, int index, short element)
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 isnull
, 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]
- Parameters:
array
- the array to add the element to, may benull
index
- the position of the new objectelement
- the object to add
- Returns:
- A new array containing the existing elements and the new element
public static short[] add(short[] array, short element)
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 isnull
, 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]
- Parameters:
array
- the array to copy and add the element to, may benull
element
- the object to add at the last index of the new array
- Returns:
- A new array containing the existing elements plus the new element
- Since:
- 2.1
public static Object[] addAll(Object[] array1, Object[] array2)
Adds all the elements of the given arrays into a new array. The new array contains all of the element ofarray1
followed by all of the elementsarray2
. 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"]
- Parameters:
array1
- the first array whose elements are added to the new array, may benull
array2
- the second array whose elements are added to the new array, may benull
- Returns:
- The new array,
null
ifnull
array inputs. The type of the new array is the type of the first array.
- Since:
- 2.1
public static boolean[] addAll(boolean[] array1, boolean[] array2)
Adds all the elements of the given arrays into a new array. The new array contains all of the element ofarray1
followed by all of the elementsarray2
. 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([], []) = []
- Parameters:
array1
- the first array whose elements are added to the new array.array2
- the second array whose elements are added to the new array.
- Returns:
- The new boolean[] array.
- Since:
- 2.1
public static byte[] addAll(byte[] array1, byte[] array2)
Adds all the elements of the given arrays into a new array. The new array contains all of the element ofarray1
followed by all of the elementsarray2
. 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([], []) = []
- Parameters:
array1
- the first array whose elements are added to the new array.array2
- the second array whose elements are added to the new array.
- Returns:
- The new byte[] array.
- Since:
- 2.1
public static char[] addAll(char[] array1, char[] array2)
Adds all the elements of the given arrays into a new array. The new array contains all of the element ofarray1
followed by all of the elementsarray2
. 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([], []) = []
- Parameters:
array1
- the first array whose elements are added to the new array.array2
- the second array whose elements are added to the new array.
- Returns:
- The new char[] array.
- Since:
- 2.1
public static double[] addAll(double[] array1, double[] array2)
Adds all the elements of the given arrays into a new array. The new array contains all of the element ofarray1
followed by all of the elementsarray2
. 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([], []) = []
- Parameters:
array1
- the first array whose elements are added to the new array.array2
- the second array whose elements are added to the new array.
- Returns:
- The new double[] array.
- Since:
- 2.1
public static float[] addAll(float[] array1, float[] array2)
Adds all the elements of the given arrays into a new array. The new array contains all of the element ofarray1
followed by all of the elementsarray2
. 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([], []) = []
- Parameters:
array1
- the first array whose elements are added to the new array.array2
- the second array whose elements are added to the new array.
- Returns:
- The new float[] array.
- Since:
- 2.1
public static int[] addAll(int[] array1, int[] array2)
Adds all the elements of the given arrays into a new array. The new array contains all of the element ofarray1
followed by all of the elementsarray2
. 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([], []) = []
- Parameters:
array1
- the first array whose elements are added to the new array.array2
- the second array whose elements are added to the new array.
- Returns:
- The new int[] array.
- Since:
- 2.1
public static long[] addAll(long[] array1, long[] array2)
Adds all the elements of the given arrays into a new array. The new array contains all of the element ofarray1
followed by all of the elementsarray2
. 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([], []) = []
- Parameters:
array1
- the first array whose elements are added to the new array.array2
- the second array whose elements are added to the new array.
- Returns:
- The new long[] array.
- Since:
- 2.1
public static short[] addAll(short[] array1, short[] array2)
Adds all the elements of the given arrays into a new array. The new array contains all of the element ofarray1
followed by all of the elementsarray2
. 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([], []) = []
- Parameters:
array1
- the first array whose elements are added to the new array.array2
- the second array whose elements are added to the new array.
- Returns:
- The new short[] array.
- Since:
- 2.1
public static Object[] clone(Object[] array)
Shallow clones an array returning a typecast result and handlingnull
. The objects in the array are not cloned, thus there is no special handling for multi-dimensional arrays. This method returnsnull
ifnull
array input.
- Parameters:
array
- the array to shallow clone, may benull
- Returns:
- the cloned array,
null
ifnull
input
public static boolean[] clone(boolean[] array)
Clones an array returning a typecast result and handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- the array to clone, may benull
- Returns:
- the cloned array,
null
ifnull
input
public static byte[] clone(byte[] array)
Clones an array returning a typecast result and handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- the array to clone, may benull
- Returns:
- the cloned array,
null
ifnull
input
public static char[] clone(char[] array)
Clones an array returning a typecast result and handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- the array to clone, may benull
- Returns:
- the cloned array,
null
ifnull
input
public static double[] clone(double[] array)
Clones an array returning a typecast result and handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- the array to clone, may benull
- Returns:
- the cloned array,
null
ifnull
input
public static float[] clone(float[] array)
Clones an array returning a typecast result and handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- the array to clone, may benull
- Returns:
- the cloned array,
null
ifnull
input
public static int[] clone(int[] array)
Clones an array returning a typecast result and handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- the array to clone, may benull
- Returns:
- the cloned array,
null
ifnull
input
public static long[] clone(long[] array)
Clones an array returning a typecast result and handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- the array to clone, may benull
- Returns:
- the cloned array,
null
ifnull
input
public static short[] clone(short[] array)
Clones an array returning a typecast result and handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- the array to clone, may benull
- Returns:
- the cloned array,
null
ifnull
input
public static boolean contains(Object[] array, Object objectToFind)
Checks if the object is in the given array. The method returnsfalse
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
public static boolean contains(boolean[] array, boolean valueToFind)
Checks if the value is in the given array. The method returnsfalse
if anull
array is passed in.
- Parameters:
array
- the array to search throughvalueToFind
- the value to find
- Returns:
true
if the array contains the object
public static boolean contains(byte[] array, byte valueToFind)
Checks if the value is in the given array. The method returnsfalse
if anull
array is passed in.
- Parameters:
array
- the array to search throughvalueToFind
- the value to find
- Returns:
true
if the array contains the object
public static boolean contains(char[] array, char valueToFind)
Checks if the value is in the given array. The method returnsfalse
if anull
array is passed in.
- Parameters:
array
- the array to search throughvalueToFind
- the value to find
- Returns:
true
if the array contains the object
- Since:
- 2.1
public static boolean contains(double[] array, double valueToFind)
Checks if the value is in the given array. The method returnsfalse
if anull
array is passed in.
- Parameters:
array
- the array to search throughvalueToFind
- the value to find
- Returns:
true
if the array contains the object
public static boolean contains(double[] array, double valueToFind, double tolerance)
Checks if a value falling within the given tolerance is in the given array. If the array contains a value within the inclusive range defined by (value - tolerance) to (value + tolerance). The method returnsfalse
if anull
array is passed in.
- Parameters:
array
- the array to searchvalueToFind
- the value to findtolerance
- the array contains the tolerance of the search
- Returns:
- true if value falling within tolerance is in array
public static boolean contains(float[] array, float valueToFind)
Checks if the value is in the given array. The method returnsfalse
if anull
array is passed in.
- Parameters:
array
- the array to search throughvalueToFind
- the value to find
- Returns:
true
if the array contains the object
public static boolean contains(int[] array, int valueToFind)
Checks if the value is in the given array. The method returnsfalse
if anull
array is passed in.
- Parameters:
array
- the array to search throughvalueToFind
- the value to find
- Returns:
true
if the array contains the object
public static boolean contains(long[] array, long valueToFind)
Checks if the value is in the given array. The method returnsfalse
if anull
array is passed in.
- Parameters:
array
- the array to search throughvalueToFind
- the value to find
- Returns:
true
if the array contains the object
public static boolean contains(short[] array, short valueToFind)
Checks if the value is in the given array. The method returnsfalse
if anull
array is passed in.
- Parameters:
array
- the array to search throughvalueToFind
- the value to find
- Returns:
true
if the array contains the object
public static int getLength(Object array)
Returns the length of the specified array. This method can deal withObject
arrays and with primitive arrays. If the input array isnull
,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
- Parameters:
array
- the array to retrieve the length from, may be null
- Returns:
- The length of the array, or
0
if the array isnull
- Since:
- 2.1
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 benull
- Returns:
- a hashCode for the array, zero if null array input
public static int indexOf(Object[] array, Object objectToFind)
Find the index of the given object in the array. This method returns-1
ifnull
array input.
- 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,
-1
if not found ornull
array input
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
ifnull
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 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,
-1
if not found ornull
array input
public static int indexOf(boolean[] array, boolean valueToFind)
Find the index of the given value in the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to search through for the object, may benull
valueToFind
- the value to find
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(boolean[] array, boolean valueToFind, int startIndex)
Find the index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the index to start searching at
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(byte[] array, byte valueToFind)
Find the index of the given value in the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to search through for the object, may benull
valueToFind
- the value to find
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(byte[] array, byte valueToFind, int startIndex)
Find the index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the index to start searching at
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(char[] array, char valueToFind)
Find the index of the given value in the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to search through for the object, may benull
valueToFind
- the value to find
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
- Since:
- 2.1
public static int indexOf(char[] array, char valueToFind, int startIndex)
Find the index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the index to start searching at
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
- Since:
- 2.1
public static int indexOf(double[] array, double valueToFind)
Find the index of the given value in the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to search through for the object, may benull
valueToFind
- the value to find
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(double[] array, double valueToFind, double tolerance)
Find the index of the given value within a given tolerance in the array. This method will return the index of the first value which falls between the region defined by valueToFind - tolerance and valueToFind + tolerance. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to search through for the object, may benull
valueToFind
- the value to findtolerance
- tolerance of the search
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(double[] array, double valueToFind, int startIndex)
Find the index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the index to start searching at
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(double[] array, double valueToFind, int startIndex, double tolerance)
Find the index of the given value in the array starting at the given index. This method will return the index of the first value which falls between the region defined by valueToFind - tolerance and valueToFind + tolerance. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the index to start searching attolerance
- tolerance of the search
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(float[] array, float valueToFind)
Find the index of the given value in the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to search through for the object, may benull
valueToFind
- the value to find
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(float[] array, float valueToFind, int startIndex)
Find the index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the index to start searching at
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(int[] array, int valueToFind)
Find the index of the given value in the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to search through for the object, may benull
valueToFind
- the value to find
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(int[] array, int valueToFind, int startIndex)
Find the index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the index to start searching at
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(long[] array, long valueToFind)
Find the index of the given value in the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to search through for the object, may benull
valueToFind
- the value to find
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(long[] array, long valueToFind, int startIndex)
Find the index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the index to start searching at
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(short[] array, short valueToFind)
Find the index of the given value in the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to search through for the object, may benull
valueToFind
- the value to find
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int indexOf(short[] array, short valueToFind, int startIndex)
Find the index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the index to start searching at
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static boolean isEmpty(Object[] array)
Checks if an array of Objects is empty ornull
.
- Parameters:
array
- the array to test
- Returns:
true
if the array is empty ornull
- Since:
- 2.1
public static boolean isEmpty(boolean[] array)
Checks if an array of primitive booleans is empty ornull
.
- Parameters:
array
- the array to test
- Returns:
true
if the array is empty ornull
- Since:
- 2.1
public static boolean isEmpty(byte[] array)
Checks if an array of primitive bytes is empty ornull
.
- Parameters:
array
- the array to test
- Returns:
true
if the array is empty ornull
- Since:
- 2.1
public static boolean isEmpty(char[] array)
Checks if an array of primitive chars is empty ornull
.
- Parameters:
array
- the array to test
- Returns:
true
if the array is empty ornull
- Since:
- 2.1
public static boolean isEmpty(double[] array)
Checks if an array of primitive doubles is empty ornull
.
- Parameters:
array
- the array to test
- Returns:
true
if the array is empty ornull
- Since:
- 2.1
public static boolean isEmpty(float[] array)
Checks if an array of primitive floats is empty ornull
.
- Parameters:
array
- the array to test
- Returns:
true
if the array is empty ornull
- Since:
- 2.1
public static boolean isEmpty(int[] array)
Checks if an array of primitive ints is empty ornull
.
- Parameters:
array
- the array to test
- Returns:
true
if the array is empty ornull
- Since:
- 2.1
public static boolean isEmpty(long[] array)
Checks if an array of primitive longs is empty ornull
.
- Parameters:
array
- the array to test
- Returns:
true
if the array is empty ornull
- Since:
- 2.1
public static boolean isEmpty(short[] array)
Checks if an array of primitive shorts is empty ornull
.
- Parameters:
array
- the array to test
- Returns:
true
if the array is empty ornull
- Since:
- 2.1
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 left hand array to compare, may benull
array2
- the right hand array to compare, may benull
- Returns:
true
if the arrays are equal
public static boolean isSameLength(Object[] array1, Object[] array2)
Checks whether two arrays are the same length, treatingnull
arrays as length0
. Any multi-dimensional aspects of the arrays are ignored.
- Parameters:
array1
- the first array, may benull
array2
- the second array, may benull
- Returns:
true
if length of arrays matches, treatingnull
as an empty array
public static boolean isSameLength(boolean[] array1, boolean[] array2)
Checks whether two arrays are the same length, treatingnull
arrays as length0
.
- Parameters:
array1
- the first array, may benull
array2
- the second array, may benull
- Returns:
true
if length of arrays matches, treatingnull
as an empty array
public static boolean isSameLength(byte[] array1, byte[] array2)
Checks whether two arrays are the same length, treatingnull
arrays as length0
.
- Parameters:
array1
- the first array, may benull
array2
- the second array, may benull
- Returns:
true
if length of arrays matches, treatingnull
as an empty array
public static boolean isSameLength(char[] array1, char[] array2)
Checks whether two arrays are the same length, treatingnull
arrays as length0
.
- Parameters:
array1
- the first array, may benull
array2
- the second array, may benull
- Returns:
true
if length of arrays matches, treatingnull
as an empty array
public static boolean isSameLength(double[] array1, double[] array2)
Checks whether two arrays are the same length, treatingnull
arrays as length0
.
- Parameters:
array1
- the first array, may benull
array2
- the second array, may benull
- Returns:
true
if length of arrays matches, treatingnull
as an empty array
public static boolean isSameLength(float[] array1, float[] array2)
Checks whether two arrays are the same length, treatingnull
arrays as length0
.
- Parameters:
array1
- the first array, may benull
array2
- the second array, may benull
- Returns:
true
if length of arrays matches, treatingnull
as an empty array
public static boolean isSameLength(int[] array1, int[] array2)
Checks whether two arrays are the same length, treatingnull
arrays as length0
.
- Parameters:
array1
- the first array, may benull
array2
- the second array, may benull
- Returns:
true
if length of arrays matches, treatingnull
as an empty array
public static boolean isSameLength(long[] array1, long[] array2)
Checks whether two arrays are the same length, treatingnull
arrays as length0
.
- Parameters:
array1
- the first array, may benull
array2
- the second array, may benull
- Returns:
true
if length of arrays matches, treatingnull
as an empty array
public static boolean isSameLength(short[] array1, short[] array2)
Checks whether two arrays are the same length, treatingnull
arrays as length0
.
- Parameters:
array1
- the first array, may benull
array2
- the second array, may benull
- Returns:
true
if length of arrays matches, treatingnull
as an empty array
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 benull
array2
- the second array, must not benull
- Returns:
true
if type of arrays matches
public static int lastIndexOf(Object[] array, Object objectToFind)
Find the last index of the given object within the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to travers backwords looking for the object, may benull
objectToFind
- the object to find, may benull
- Returns:
- the last index of the object within the array,
-1
if not found ornull
array input
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
ifnull
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 benull
objectToFind
- the object to find, may benull
startIndex
- the start index to travers backwards from
- Returns:
- the last index of the object within the array,
-1
if not found ornull
array input
public static int lastIndexOf(boolean[] array, boolean valueToFind)
Find the last index of the given value within the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to travers backwords looking for the object, may benull
valueToFind
- the object to find
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(boolean[] array, boolean valueToFind, int startIndex)
Find the last index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the start index to travers backwards from
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(byte[] array, byte valueToFind)
Find the last index of the given value within the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to travers backwords looking for the object, may benull
valueToFind
- the object to find
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(byte[] array, byte valueToFind, int startIndex)
Find the last index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the start index to travers backwards from
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(char[] array, char valueToFind)
Find the last index of the given value within the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to travers backwords looking for the object, may benull
valueToFind
- the object to find
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
- Since:
- 2.1
public static int lastIndexOf(char[] array, char valueToFind, int startIndex)
Find the last index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the start index to travers backwards from
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
- Since:
- 2.1
public static int lastIndexOf(double[] array, double valueToFind)
Find the last index of the given value within the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to travers backwords looking for the object, may benull
valueToFind
- the object to find
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(double[] array, double valueToFind, double tolerance)
Find the last index of the given value within a given tolerance in the array. This method will return the index of the last value which falls between the region defined by valueToFind - tolerance and valueToFind + tolerance. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to search through for the object, may benull
valueToFind
- the value to findtolerance
- tolerance of the search
- Returns:
- the index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(double[] array, double valueToFind, int startIndex)
Find the last index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the start index to travers backwards from
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
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
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the start index to travers backwards fromtolerance
- search for value within plus/minus this amount
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(float[] array, float valueToFind)
Find the last index of the given value within the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to travers backwords looking for the object, may benull
valueToFind
- the object to find
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(float[] array, float valueToFind, int startIndex)
Find the last index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the start index to travers backwards from
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(int[] array, int valueToFind)
Find the last index of the given value within the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to travers backwords looking for the object, may benull
valueToFind
- the object to find
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(int[] array, int valueToFind, int startIndex)
Find the last index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the start index to travers backwards from
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(long[] array, long valueToFind)
Find the last index of the given value within the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to travers backwords looking for the object, may benull
valueToFind
- the object to find
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(long[] array, long valueToFind, int startIndex)
Find the last index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the start index to travers backwards from
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(short[] array, short valueToFind)
Find the last index of the given value within the array. This method returns-1
ifnull
array input.
- Parameters:
array
- the array to travers backwords looking for the object, may benull
valueToFind
- the object to find
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static int lastIndexOf(short[] array, short valueToFind, int startIndex)
Find the last index of the given value in the array starting at the given index. This method returns-1
ifnull
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 benull
valueToFind
- the value to findstartIndex
- the start index to travers backwards from
- Returns:
- the last index of the value within the array,
-1
if not found ornull
array input
public static Object[] remove(Object[] array, int index)
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 isnull
, 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"]
- Parameters:
array
- the array to remove the element from, may not benull
index
- the position of the element to be removed
- Returns:
- A new array containing the existing elements except the element at the specified position.
- Since:
- 2.1
public static boolean[] remove(boolean[] array, int index)
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 isnull
, 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]
- Parameters:
array
- the array to remove the element from, may not benull
index
- the position of the element to be removed
- Returns:
- A new array containing the existing elements except the element at the specified position.
- Since:
- 2.1
public static byte[] remove(byte[] array, int index)
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 isnull
, 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]
- Parameters:
array
- the array to remove the element from, may not benull
index
- the position of the element to be removed
- Returns:
- A new array containing the existing elements except the element at the specified position.
- Since:
- 2.1
public static char[] remove(char[] array, int index)
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 isnull
, 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']
- Parameters:
array
- the array to remove the element from, may not benull
index
- the position of the element to be removed
- Returns:
- A new array containing the existing elements except the element at the specified position.
- Since:
- 2.1
public static double[] remove(double[] array, int index)
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 isnull
, 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]
- Parameters:
array
- the array to remove the element from, may not benull
index
- the position of the element to be removed
- Returns:
- A new array containing the existing elements except the element at the specified position.
- Since:
- 2.1
public static float[] remove(float[] array, int index)
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 isnull
, 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]
- Parameters:
array
- the array to remove the element from, may not benull
index
- the position of the element to be removed
- Returns:
- A new array containing the existing elements except the element at the specified position.
- Since:
- 2.1
public static int[] remove(int[] array, int index)
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 isnull
, 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]
- Parameters:
array
- the array to remove the element from, may not benull
index
- the position of the element to be removed
- Returns:
- A new array containing the existing elements except the element at the specified position.
- Since:
- 2.1
public static long[] remove(long[] array, int index)
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 isnull
, 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]
- Parameters:
array
- the array to remove the element from, may not benull
index
- the position of the element to be removed
- Returns:
- A new array containing the existing elements except the element at the specified position.
- Since:
- 2.1
public static short[] remove(short[] array, int index)
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 isnull
, 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]
- Parameters:
array
- the array to remove the element from, may not benull
index
- the position of the element to be removed
- Returns:
- A new array containing the existing elements except the element at the specified position.
- Since:
- 2.1
public static Object[] removeElement(Object[] array, Object element)
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"]
- Parameters:
array
- the array to remove the element from, may benull
element
- the element to be removed
- Returns:
- A new array containing the existing elements except the first occurrence of the specified element.
- Since:
- 2.1
public static boolean[] removeElement(boolean[] array, boolean element)
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]
- Parameters:
array
- the array to remove the element from, may benull
element
- the element to be removed
- Returns:
- A new array containing the existing elements except the first occurrence of the specified element.
- Since:
- 2.1
public static byte[] removeElement(byte[] array, byte element)
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]
- Parameters:
array
- the array to remove the element from, may benull
element
- the element to be removed
- Returns:
- A new array containing the existing elements except the first occurrence of the specified element.
- Since:
- 2.1
public static char[] removeElement(char[] array, char element)
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']
- Parameters:
array
- the array to remove the element from, may benull
element
- the element to be removed
- Returns:
- A new array containing the existing elements except the first occurrence of the specified element.
- Since:
- 2.1
public static double[] removeElement(double[] array, double element)
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]
- Parameters:
array
- the array to remove the element from, may benull
element
- the element to be removed
- Returns:
- A new array containing the existing elements except the first occurrence of the specified element.
- Since:
- 2.1
public static float[] removeElement(float[] array, float element)
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]
- Parameters:
array
- the array to remove the element from, may benull
element
- the element to be removed
- Returns:
- A new array containing the existing elements except the first occurrence of the specified element.
- Since:
- 2.1
public static int[] removeElement(int[] array, int element)
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]
- Parameters:
array
- the array to remove the element from, may benull
element
- the element to be removed
- Returns:
- A new array containing the existing elements except the first occurrence of the specified element.
- Since:
- 2.1
public static long[] removeElement(long[] array, long element)
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]
- Parameters:
array
- the array to remove the element from, may benull
element
- the element to be removed
- Returns:
- A new array containing the existing elements except the first occurrence of the specified element.
- Since:
- 2.1
public static short[] removeElement(short[] array, short element)
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]
- Parameters:
array
- the array to remove the element from, may benull
element
- the element to be removed
- Returns:
- A new array containing the existing elements except the first occurrence of the specified element.
- Since:
- 2.1
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 ifnull
array input.
- Parameters:
array
- the array to reverse, may benull
public static void reverse(boolean[] array)
Reverses the order of the given array. This method does nothing ifnull
array input.
- Parameters:
array
- the array to reverse, may benull
public static void reverse(byte[] array)
Reverses the order of the given array. This method does nothing ifnull
array input.
- Parameters:
array
- the array to reverse, may benull
public static void reverse(char[] array)
Reverses the order of the given array. This method does nothing ifnull
array input.
- Parameters:
array
- the array to reverse, may benull
public static void reverse(double[] array)
Reverses the order of the given array. This method does nothing ifnull
array input.
- Parameters:
array
- the array to reverse, may benull
public static void reverse(float[] array)
Reverses the order of the given array. This method does nothing ifnull
array input.
- Parameters:
array
- the array to reverse, may benull
public static void reverse(int[] array)
Reverses the order of the given array. This method does nothing ifnull
array input.
- Parameters:
array
- the array to reverse, may benull
public static void reverse(long[] array)
Reverses the order of the given array. This method does nothing ifnull
array input.
- Parameters:
array
- the array to reverse, may benull
public static void reverse(short[] array)
Reverses the order of the given array. This method does nothing ifnull
array input.
- Parameters:
array
- the array to reverse, may benull
public static Object[] subarray(Object[] array, int startIndexInclusive, int endIndexExclusive)
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 typeDate
, the following usage is envisaged:Date[] someDates = (Date[])ArrayUtils.subarray(allDates, 2, 5);
- Parameters:
array
- the arraystartIndexInclusive
- the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in an empty array.endIndexExclusive
- elements up to endIndex-1 are present in the returned subarray. Undervalue (< startIndex) produces empty array, overvalue (>array.length) is demoted to array length.
- Returns:
- a new array containing the elements between the start and end indices.
- Since:
- 2.1
public static boolean[] subarray(boolean[] array, int startIndexInclusive, int endIndexExclusive)
Produces a newboolean
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.
- Parameters:
array
- the arraystartIndexInclusive
- the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in an empty array.endIndexExclusive
- elements up to endIndex-1 are present in the returned subarray. Undervalue (< startIndex) produces empty array, overvalue (>array.length) is demoted to array length.
- Returns:
- a new array containing the elements between the start and end indices.
- Since:
- 2.1
public static byte[] subarray(byte[] array, int startIndexInclusive, int endIndexExclusive)
Produces a newbyte
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.
- Parameters:
array
- the arraystartIndexInclusive
- the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in an empty array.endIndexExclusive
- elements up to endIndex-1 are present in the returned subarray. Undervalue (< startIndex) produces empty array, overvalue (>array.length) is demoted to array length.
- Returns:
- a new array containing the elements between the start and end indices.
- Since:
- 2.1
public static char[] subarray(char[] array, int startIndexInclusive, int endIndexExclusive)
Produces a newchar
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.
- Parameters:
array
- the arraystartIndexInclusive
- the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in an empty array.endIndexExclusive
- elements up to endIndex-1 are present in the returned subarray. Undervalue (< startIndex) produces empty array, overvalue (>array.length) is demoted to array length.
- Returns:
- a new array containing the elements between the start and end indices.
- Since:
- 2.1
public static double[] subarray(double[] array, int startIndexInclusive, int endIndexExclusive)
Produces a newdouble
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.
- Parameters:
array
- the arraystartIndexInclusive
- the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in an empty array.endIndexExclusive
- elements up to endIndex-1 are present in the returned subarray. Undervalue (< startIndex) produces empty array, overvalue (>array.length) is demoted to array length.
- Returns:
- a new array containing the elements between the start and end indices.
- Since:
- 2.1
public static float[] subarray(float[] array, int startIndexInclusive, int endIndexExclusive)
Produces a newfloat
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.
- Parameters:
array
- the arraystartIndexInclusive
- the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in an empty array.endIndexExclusive
- elements up to endIndex-1 are present in the returned subarray. Undervalue (< startIndex) produces empty array, overvalue (>array.length) is demoted to array length.
- Returns:
- a new array containing the elements between the start and end indices.
- Since:
- 2.1
public static int[] subarray(int[] array, int startIndexInclusive, int endIndexExclusive)
Produces a newint
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.
- Parameters:
array
- the arraystartIndexInclusive
- the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in an empty array.endIndexExclusive
- elements up to endIndex-1 are present in the returned subarray. Undervalue (< startIndex) produces empty array, overvalue (>array.length) is demoted to array length.
- Returns:
- a new array containing the elements between the start and end indices.
- Since:
- 2.1
public static long[] subarray(long[] array, int startIndexInclusive, int endIndexExclusive)
Produces a newlong
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.
- Parameters:
array
- the arraystartIndexInclusive
- the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in an empty array.endIndexExclusive
- elements up to endIndex-1 are present in the returned subarray. Undervalue (< startIndex) produces empty array, overvalue (>array.length) is demoted to array length.
- Returns:
- a new array containing the elements between the start and end indices.
- Since:
- 2.1
public static short[] subarray(short[] array, int startIndexInclusive, int endIndexExclusive)
Produces a newshort
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.
- Parameters:
array
- the arraystartIndexInclusive
- the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in an empty array.endIndexExclusive
- elements up to endIndex-1 are present in the returned subarray. Undervalue (< startIndex) produces empty array, overvalue (>array.length) is demoted to array length.
- Returns:
- a new array containing the elements between the start and end indices.
- Since:
- 2.1
public static Map toMap(Object[] array)
Converts the given array into aMap
. Each element of the array must be either aMap.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 returnsnull
ifnull
array input.
- Parameters:
array
- an array whose elements are either aMap.Entry
or an Array containing at least two elements, may benull
- Returns:
- a
Map
that was created from the array
public static Boolean[] toObject(boolean[] array)
Converts an array of primitive booleans to objects. This method returnsnull
ifnull
array input.
- Parameters:
array
- aboolean
array
- Returns:
- a
Boolean
array,null
if null array input
public static Byte[] toObject(byte[] array)
Converts an array of primitive bytes to objects. This method returnsnull
ifnull
array input.
- Parameters:
array
- abyte
array
- Returns:
- a
Byte
array,null
if null array input
public static Double[] toObject(double[] array)
Converts an array of primitive doubles to objects. This method returnsnull
ifnull
array input.
- Parameters:
array
- adouble
array
- Returns:
- a
Double
array,null
if null array input
public static Float[] toObject(float[] array)
Converts an array of primitive floats to objects. This method returnsnull
ifnull
array input.
- Parameters:
array
- afloat
array
- Returns:
- a
Float
array,null
if null array input
public static Integer[] toObject(int[] array)
Converts an array of primitive ints to objects. This method returnsnull
ifnull
array input.
- Parameters:
array
- anint
array
- Returns:
- an
Integer
array,null
if null array input
public static Long[] toObject(long[] array)
Converts an array of primitive longs to objects. This method returnsnull
ifnull
array input.
- Parameters:
array
- along
array
- Returns:
- a
Long
array,null
if null array input
public static Short[] toObject(short[] array)
Converts an array of primitive shorts to objects. This method returnsnull
ifnull
array input.
- Parameters:
array
- ashort
array
- Returns:
- a
Short
array,null
if null array input
public static boolean[] toPrimitive(Boolean[] array)
Converts an array of object Booleans to primitives. This method returnsnull
ifnull
array input.
- Parameters:
array
- aBoolean
array, may benull
- Returns:
- a
boolean
array,null
if null array input
public static boolean[] toPrimitive(Boolean[] array, boolean valueForNull)
Converts an array of object Booleans to primitives handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- aBoolean
array, may benull
valueForNull
- the value to insert ifnull
found
- Returns:
- a
boolean
array,null
if null array input
public static byte[] toPrimitive(Byte[] array)
Converts an array of object Bytes to primitives. This method returnsnull
ifnull
array input.
- Parameters:
array
- aByte
array, may benull
- Returns:
- a
byte
array,null
if null array input
public static byte[] toPrimitive(Byte[] array, byte valueForNull)
Converts an array of object Bytes to primitives handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- aByte
array, may benull
valueForNull
- the value to insert ifnull
found
- Returns:
- a
byte
array,null
if null array input
public static double[] toPrimitive(Double[] array)
Converts an array of object Doubles to primitives. This method returnsnull
ifnull
array input.
- Parameters:
array
- aDouble
array, may benull
- Returns:
- a
double
array,null
if null array input
public static double[] toPrimitive(Double[] array, double valueForNull)
Converts an array of object Doubles to primitives handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- aDouble
array, may benull
valueForNull
- the value to insert ifnull
found
- Returns:
- a
double
array,null
if null array input
public static float[] toPrimitive(Float[] array)
Converts an array of object Floats to primitives. This method returnsnull
ifnull
array input.
- Parameters:
array
- aFloat
array, may benull
- Returns:
- a
float
array,null
if null array input
public static float[] toPrimitive(Float[] array, float valueForNull)
Converts an array of object Floats to primitives handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- aFloat
array, may benull
valueForNull
- the value to insert ifnull
found
- Returns:
- a
float
array,null
if null array input
public static int[] toPrimitive(Integer[] array)
Converts an array of object Integers to primitives. This method returnsnull
ifnull
array input.
- Parameters:
array
- aInteger
array, may benull
- Returns:
- an
int
array,null
if null array input
public static int[] toPrimitive(Integer[] array, int valueForNull)
Converts an array of object Integer to primitives handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- aInteger
array, may benull
valueForNull
- the value to insert ifnull
found
- Returns:
- an
int
array,null
if null array input
public static long[] toPrimitive(Long[] array)
Converts an array of object Longs to primitives. This method returnsnull
ifnull
array input.
- Parameters:
array
- aLong
array, may benull
- Returns:
- a
long
array,null
if null array input
public static long[] toPrimitive(Long[] array, long valueForNull)
Converts an array of object Long to primitives handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- aLong
array, may benull
valueForNull
- the value to insert ifnull
found
- Returns:
- a
long
array,null
if null array input
public static short[] toPrimitive(Short[] array)
Converts an array of object Shorts to primitives. This method returnsnull
ifnull
array input.
- Parameters:
array
- aShort
array, may benull
- Returns:
- a
byte
array,null
if null array input
public static short[] toPrimitive(Short[] array, short valueForNull)
Converts an array of object Short to primitives handlingnull
. This method returnsnull
ifnull
array input.
- Parameters:
array
- aShort
array, may benull
valueForNull
- the value to insert ifnull
found
- Returns:
- a
byte
array,null
if null array input
public static String toString(Object array)
Outputs an array as a String, treatingnull
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 benull
- Returns:
- a String representation of the array, '{}' if null array input
public static String toString(Object array, String stringIfNull)
Outputs an array as a String handlingnull
s. 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 benull
stringIfNull
- the String to return if the array isnull
- Returns:
- a String representation of the array