ArrayUtils (Steve Wedig's Libraries for Java 7+ 2.0.2 API)

java.lang.Object
- com.stevewedig.blog.apache.commons.lang3.ArrayUtils

```
public abstract class ArrayUtils
extends Object
```
Operations on arrays, primitive arrays (like int[]) and primitive wrapper arrays (like Integer[]).

This class tries to handle null input gracefully. An exception will not be thrown for a null array input. However, an Object array that contains a null element may throw an exception. Each method documents its behaviour.

#ThreadSafe#

Since:

2.0

Version:

$Id$

Field Summary

Fields
Modifier and Type	Field and Description
`static boolean[]`	`EMPTY_BOOLEAN_ARRAY` An empty immutable `boolean` array.
`static Boolean[]`	`EMPTY_BOOLEAN_OBJECT_ARRAY` An empty immutable `Boolean` array.
`static byte[]`	`EMPTY_BYTE_ARRAY` An empty immutable `byte` array.
`static Byte[]`	`EMPTY_BYTE_OBJECT_ARRAY` An empty immutable `Byte` array.
`static char[]`	`EMPTY_CHAR_ARRAY` An empty immutable `char` array.
`static Character[]`	`EMPTY_CHARACTER_OBJECT_ARRAY` An empty immutable `Character` array.
`static Class<?>[]`	`EMPTY_CLASS_ARRAY` An empty immutable `Class` array.
`static double[]`	`EMPTY_DOUBLE_ARRAY` An empty immutable `double` array.
`static Double[]`	`EMPTY_DOUBLE_OBJECT_ARRAY` An empty immutable `Double` array.
`static float[]`	`EMPTY_FLOAT_ARRAY` An empty immutable `float` array.
`static Float[]`	`EMPTY_FLOAT_OBJECT_ARRAY` An empty immutable `Float` array.
`static int[]`	`EMPTY_INT_ARRAY` An empty immutable `int` array.
`static Integer[]`	`EMPTY_INTEGER_OBJECT_ARRAY` An empty immutable `Integer` array.
`static long[]`	`EMPTY_LONG_ARRAY` An empty immutable `long` array.
`static Long[]`	`EMPTY_LONG_OBJECT_ARRAY` An empty immutable `Long` array.
`static Object[]`	`EMPTY_OBJECT_ARRAY` An empty immutable `Object` array.
`static short[]`	`EMPTY_SHORT_ARRAY` An empty immutable `short` array.
`static Short[]`	`EMPTY_SHORT_OBJECT_ARRAY` An empty immutable `Short` array.
`static String[]`	`EMPTY_STRING_ARRAY` An empty immutable `String` array.
`static int`	`INDEX_NOT_FOUND` The index value when an element is not found in a list or array: `-1`.

Constructor Summary

Constructors
Constructor and Description

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

Constructors
Constructor and Description
`ArrayUtils()` ArrayUtils instances should NOT be constructed in standard programming.

Method Summary

Methods
Modifier and Type	Method and Description
`static boolean`	`contains(boolean[] array, boolean valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(byte[] array, byte valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(char[] array, char valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(double[] array, double valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(double[] array, double valueToFind, double tolerance)` Checks if a value falling within the given tolerance is in the given array.
`static boolean`	`contains(float[] array, float valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(int[] array, int valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(long[] array, long valueToFind)` Checks if the value is in the given array.
`static boolean`	`contains(short[] array, short valueToFind)` Checks if the value is in the given array.
`static int`	`indexOf(boolean[] array, boolean valueToFind)` Finds the index of the given value in the array.
`static int`	`indexOf(boolean[] array, boolean valueToFind, int startIndex)` Finds the index of the given value in the array starting at the given index.
`static int`	`indexOf(byte[] array, byte valueToFind)` Finds the index of the given value in the array.
`static int`	`indexOf(byte[] array, byte valueToFind, int startIndex)` Finds the index of the given value in the array starting at the given index.
`static int`	`indexOf(char[] array, char valueToFind)` Finds the index of the given value in the array.
`static int`	`indexOf(char[] array, char valueToFind, int startIndex)` Finds the index of the given value in the array starting at the given index.
`static int`	`indexOf(double[] array, double valueToFind)` Finds the index of the given value in the array.
`static int`	`indexOf(double[] array, double valueToFind, double tolerance)` Finds the index of the given value within a given tolerance in the array.
`static int`	`indexOf(double[] array, double valueToFind, int startIndex)` Finds the index of the given value in the array starting at the given index.
`static int`	`indexOf(double[] array, double valueToFind, int startIndex, double tolerance)` Finds the index of the given value in the array starting at the given index.
`static int`	`indexOf(float[] array, float valueToFind)` Finds the index of the given value in the array.
`static int`	`indexOf(float[] array, float valueToFind, int startIndex)` Finds the index of the given value in the array starting at the given index.
`static int`	`indexOf(int[] array, int valueToFind)` Finds the index of the given value in the array.
`static int`	`indexOf(int[] array, int valueToFind, int startIndex)` Finds the index of the given value in the array starting at the given index.
`static int`	`indexOf(long[] array, long valueToFind)` Finds the index of the given value in the array.
`static int`	`indexOf(long[] array, long valueToFind, int startIndex)` Finds the index of the given value in the array starting at the given index.
`static int`	`indexOf(short[] array, short valueToFind)` Finds the index of the given value in the array.
`static int`	`indexOf(short[] array, short valueToFind, int startIndex)` Finds the index of the given value in the array starting at the given index.
`static boolean`	`isEmpty(boolean[] array)` Checks if an array of primitive booleans is empty or `null`.
`static boolean`	`isEmpty(byte[] array)` Checks if an array of primitive bytes is empty or `null`.
`static boolean`	`isEmpty(char[] array)` Checks if an array of primitive chars is empty or `null`.
`static boolean`	`isEmpty(double[] array)` Checks if an array of primitive doubles is empty or `null`.
`static boolean`	`isEmpty(float[] array)` Checks if an array of primitive floats is empty or `null`.
`static boolean`	`isEmpty(int[] array)` Checks if an array of primitive ints is empty or `null`.
`static boolean`	`isEmpty(long[] array)` Checks if an array of primitive longs is empty or `null`.
`static boolean`	`isEmpty(Object[] array)` Checks if an array of Objects is empty or `null`.
`static boolean`	`isEmpty(short[] array)` Checks if an array of primitive shorts is empty or `null`.
`static boolean`	`isNotEmpty(boolean[] array)` Checks if an array of primitive booleans is not empty or not `null`.
`static boolean`	`isNotEmpty(byte[] array)` Checks if an array of primitive bytes is not empty or not `null`.
`static boolean`	`isNotEmpty(char[] array)` Checks if an array of primitive chars is not empty or not `null`.
`static boolean`	`isNotEmpty(double[] array)` Checks if an array of primitive doubles is not empty or not `null`.
`static boolean`	`isNotEmpty(float[] array)` Checks if an array of primitive floats is not empty or not `null`.
`static boolean`	`isNotEmpty(int[] array)` Checks if an array of primitive ints is not empty or not `null`.
`static boolean`	`isNotEmpty(long[] array)` Checks if an array of primitive longs is not empty or not `null`.
`static boolean`	`isNotEmpty(short[] array)` Checks if an array of primitive shorts is not empty or not `null`.
`static <T> boolean`	`isNotEmpty(T[] array)` Checks if an array of Objects is not empty or not `null`.
`static boolean`	`isSameLength(boolean[] array1, boolean[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0` .
`static boolean`	`isSameLength(byte[] array1, byte[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0` .
`static boolean`	`isSameLength(char[] array1, char[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0` .
`static boolean`	`isSameLength(double[] array1, double[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0` .
`static boolean`	`isSameLength(float[] array1, float[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0` .
`static boolean`	`isSameLength(int[] array1, int[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0` .
`static boolean`	`isSameLength(long[] array1, long[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0` .
`static boolean`	`isSameLength(Object[] array1, Object[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0`.
`static boolean`	`isSameLength(short[] array1, short[] array2)` Checks whether two arrays are the same length, treating `null` arrays as length `0` .
`static boolean`	`isSameType(Object array1, Object array2)` Checks whether two arrays are the same type taking into account multi-dimensional arrays.
`static int`	`lastIndexOf(boolean[] array, boolean valueToFind)` Finds the last index of the given value within the array.
`static int`	`lastIndexOf(boolean[] array, boolean valueToFind, int startIndex)` Finds the last index of the given value in the array starting at the given index.
`static int`	`lastIndexOf(byte[] array, byte valueToFind)` Finds the last index of the given value within the array.
`static int`	`lastIndexOf(byte[] array, byte valueToFind, int startIndex)` Finds the last index of the given value in the array starting at the given index.
`static int`	`lastIndexOf(char[] array, char valueToFind)` Finds the last index of the given value within the array.
`static int`	`lastIndexOf(char[] array, char valueToFind, int startIndex)` Finds the last index of the given value in the array starting at the given index.
`static int`	`lastIndexOf(double[] array, double valueToFind)` Finds the last index of the given value within the array.
`static int`	`lastIndexOf(double[] array, double valueToFind, double tolerance)` Finds the last index of the given value within a given tolerance in the array.
`static int`	`lastIndexOf(double[] array, double valueToFind, int startIndex)` Finds the last index of the given value in the array starting at the given index.
`static int`	`lastIndexOf(double[] array, double valueToFind, int startIndex, double tolerance)` Finds the last index of the given value in the array starting at the given index.
`static int`	`lastIndexOf(float[] array, float valueToFind)` Finds the last index of the given value within the array.
`static int`	`lastIndexOf(float[] array, float valueToFind, int startIndex)` Finds the last index of the given value in the array starting at the given index.
`static int`	`lastIndexOf(int[] array, int valueToFind)` Finds the last index of the given value within the array.
`static int`	`lastIndexOf(int[] array, int valueToFind, int startIndex)` Finds the last index of the given value in the array starting at the given index.
`static int`	`lastIndexOf(long[] array, long valueToFind)` Finds the last index of the given value within the array.
`static int`	`lastIndexOf(long[] array, long valueToFind, int startIndex)` Finds the last index of the given value in the array starting at the given index.
`static int`	`lastIndexOf(short[] array, short valueToFind)` Finds the last index of the given value within the array.
`static int`	`lastIndexOf(short[] array, short valueToFind, int startIndex)` Finds the last index of the given value in the array starting at the given index.
`static boolean[]`	`nullToEmpty(boolean[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static Boolean[]`	`nullToEmpty(Boolean[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static byte[]`	`nullToEmpty(byte[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static Byte[]`	`nullToEmpty(Byte[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static char[]`	`nullToEmpty(char[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static Character[]`	`nullToEmpty(Character[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static Class<?>[]`	`nullToEmpty(Class<?>[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static double[]`	`nullToEmpty(double[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static Double[]`	`nullToEmpty(Double[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static float[]`	`nullToEmpty(float[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static Float[]`	`nullToEmpty(Float[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static int[]`	`nullToEmpty(int[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static Integer[]`	`nullToEmpty(Integer[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static long[]`	`nullToEmpty(long[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static Long[]`	`nullToEmpty(Long[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static Object[]`	`nullToEmpty(Object[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static short[]`	`nullToEmpty(short[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static Short[]`	`nullToEmpty(Short[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static String[]`	`nullToEmpty(String[] array)` Defensive programming technique to change a `null` reference to an empty one.
`static void`	`reverse(boolean[] array)` Reverses the order of the given array.
`static void`	`reverse(boolean[] array, int startIndexInclusive, int endIndexExclusive)` Reverses the order of the given array in the given range.
`static void`	`reverse(byte[] array)` Reverses the order of the given array.
`static void`	`reverse(byte[] array, int startIndexInclusive, int endIndexExclusive)` Reverses the order of the given array in the given range.
`static void`	`reverse(char[] array)` Reverses the order of the given array.
`static void`	`reverse(char[] array, int startIndexInclusive, int endIndexExclusive)` Reverses the order of the given array in the given range.
`static void`	`reverse(double[] array)` Reverses the order of the given array.
`static void`	`reverse(double[] array, int startIndexInclusive, int endIndexExclusive)` Reverses the order of the given array in the given range.
`static void`	`reverse(float[] array)` Reverses the order of the given array.
`static void`	`reverse(float[] array, int startIndexInclusive, int endIndexExclusive)` Reverses the order of the given array in the given range.
`static void`	`reverse(int[] array)` Reverses the order of the given array.
`static void`	`reverse(int[] array, int startIndexInclusive, int endIndexExclusive)` Reverses the order of the given array in the given range.
`static void`	`reverse(long[] array)` Reverses the order of the given array.
`static void`	`reverse(long[] array, int startIndexInclusive, int endIndexExclusive)` Reverses the order of the given array in the given range.
`static void`	`reverse(Object[] array)` Reverses the order of the given array.
`static void`	`reverse(Object[] array, int startIndexInclusive, int endIndexExclusive)` Reverses the order of the given array in the given range.
`static void`	`reverse(short[] array)` Reverses the order of the given array.
`static void`	`reverse(short[] array, int startIndexInclusive, int endIndexExclusive)` Reverses the order of the given array in the given range.
`static boolean[]`	`subarray(boolean[] array, int startIndexInclusive, int endIndexExclusive)` Produces a new `boolean` array containing the elements between the start and end indices.
`static byte[]`	`subarray(byte[] array, int startIndexInclusive, int endIndexExclusive)` Produces a new `byte` array containing the elements between the start and end indices.
`static char[]`	`subarray(char[] array, int startIndexInclusive, int endIndexExclusive)` Produces a new `char` array containing the elements between the start and end indices.
`static double[]`	`subarray(double[] array, int startIndexInclusive, int endIndexExclusive)` Produces a new `double` array containing the elements between the start and end indices.
`static float[]`	`subarray(float[] array, int startIndexInclusive, int endIndexExclusive)` Produces a new `float` array containing the elements between the start and end indices.
`static int[]`	`subarray(int[] array, int startIndexInclusive, int endIndexExclusive)` Produces a new `int` array containing the elements between the start and end indices.
`static long[]`	`subarray(long[] array, int startIndexInclusive, int endIndexExclusive)` Produces a new `long` array containing the elements between the start and end indices.
`static short[]`	`subarray(short[] array, int startIndexInclusive, int endIndexExclusive)` Produces a new `short` array containing the elements between the start and end indices.
`static Map<Object,Object>`	`toMap(Object[] array)` Converts the given array into a `Map`.
`static Boolean[]`	`toObject(boolean[] array)` Converts an array of primitive booleans to objects.
`static Byte[]`	`toObject(byte[] array)` Converts an array of primitive bytes to objects.
`static Character[]`	`toObject(char[] array)` Converts an array of primitive chars to objects.
`static Double[]`	`toObject(double[] array)` Converts an array of primitive doubles to objects.
`static Float[]`	`toObject(float[] array)` Converts an array of primitive floats to objects.
`static Integer[]`	`toObject(int[] array)` Converts an array of primitive ints to objects.
`static Long[]`	`toObject(long[] array)` Converts an array of primitive longs to objects.
`static Short[]`	`toObject(short[] array)` Converts an array of primitive shorts to objects.
`static boolean[]`	`toPrimitive(Boolean[] array)` Converts an array of object Booleans to primitives.
`static boolean[]`	`toPrimitive(Boolean[] array, boolean valueForNull)` Converts an array of object Booleans to primitives handling `null`.
`static byte[]`	`toPrimitive(Byte[] array)` Converts an array of object Bytes to primitives.
`static byte[]`	`toPrimitive(Byte[] array, byte valueForNull)` Converts an array of object Bytes to primitives handling `null`.
`static char[]`	`toPrimitive(Character[] array)` Converts an array of object Characters to primitives.
`static char[]`	`toPrimitive(Character[] array, char valueForNull)` Converts an array of object Character to primitives handling `null`.
`static double[]`	`toPrimitive(Double[] array)` Converts an array of object Doubles to primitives.
`static double[]`	`toPrimitive(Double[] array, double valueForNull)` Converts an array of object Doubles to primitives handling `null`.
`static float[]`	`toPrimitive(Float[] array)` Converts an array of object Floats to primitives.
`static float[]`	`toPrimitive(Float[] array, float valueForNull)` Converts an array of object Floats to primitives handling `null`.
`static int[]`	`toPrimitive(Integer[] array)` Converts an array of object Integers to primitives.
`static int[]`	`toPrimitive(Integer[] array, int valueForNull)` Converts an array of object Integer to primitives handling `null`.
`static long[]`	`toPrimitive(Long[] array)` Converts an array of object Longs to primitives.
`static long[]`	`toPrimitive(Long[] array, long valueForNull)` Converts an array of object Long to primitives handling `null`.
`static short[]`	`toPrimitive(Short[] array)` Converts an array of object Shorts to primitives.
`static short[]`	`toPrimitive(Short[] array, short valueForNull)` Converts an array of object Short to primitives handling `null`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - EMPTY_OBJECT_ARRAY
```
public static final Object[] EMPTY_OBJECT_ARRAY
```
    An empty immutable Object array.
  - EMPTY_CLASS_ARRAY
```
public static final Class<?>[] EMPTY_CLASS_ARRAY
```
    An empty immutable Class array.
  - EMPTY_STRING_ARRAY
```
public static final String[] EMPTY_STRING_ARRAY
```
    An empty immutable String array.
  - EMPTY_LONG_ARRAY
```
public static final long[] EMPTY_LONG_ARRAY
```
    An empty immutable long array.
  - EMPTY_LONG_OBJECT_ARRAY
```
public static final Long[] EMPTY_LONG_OBJECT_ARRAY
```
    An empty immutable Long array.
  - EMPTY_INT_ARRAY
```
public static final int[] EMPTY_INT_ARRAY
```
    An empty immutable int array.
  - EMPTY_INTEGER_OBJECT_ARRAY
```
public static final Integer[] EMPTY_INTEGER_OBJECT_ARRAY
```
    An empty immutable Integer array.
  - EMPTY_SHORT_ARRAY
```
public static final short[] EMPTY_SHORT_ARRAY
```
    An empty immutable short array.
  - EMPTY_SHORT_OBJECT_ARRAY
```
public static final Short[] EMPTY_SHORT_OBJECT_ARRAY
```
    An empty immutable Short array.
  - EMPTY_BYTE_ARRAY
```
public static final byte[] EMPTY_BYTE_ARRAY
```
    An empty immutable byte array.
  - EMPTY_BYTE_OBJECT_ARRAY
```
public static final Byte[] EMPTY_BYTE_OBJECT_ARRAY
```
    An empty immutable Byte array.
  - EMPTY_DOUBLE_ARRAY
```
public static final double[] EMPTY_DOUBLE_ARRAY
```
    An empty immutable double array.
  - EMPTY_DOUBLE_OBJECT_ARRAY
```
public static final Double[] EMPTY_DOUBLE_OBJECT_ARRAY
```
    An empty immutable Double array.
  - EMPTY_FLOAT_ARRAY
```
public static final float[] EMPTY_FLOAT_ARRAY
```
    An empty immutable float array.
  - EMPTY_FLOAT_OBJECT_ARRAY
```
public static final Float[] EMPTY_FLOAT_OBJECT_ARRAY
```
    An empty immutable Float array.
  - EMPTY_BOOLEAN_ARRAY
```
public static final boolean[] EMPTY_BOOLEAN_ARRAY
```
    An empty immutable boolean array.
  - EMPTY_BOOLEAN_OBJECT_ARRAY
```
public static final Boolean[] EMPTY_BOOLEAN_OBJECT_ARRAY
```
    An empty immutable Boolean array.
  - EMPTY_CHAR_ARRAY
```
public static final char[] EMPTY_CHAR_ARRAY
```
    An empty immutable char array.
  - EMPTY_CHARACTER_OBJECT_ARRAY
```
public static final Character[] EMPTY_CHARACTER_OBJECT_ARRAY
```
    An empty immutable Character array.
  - INDEX_NOT_FOUND
```
public static final int INDEX_NOT_FOUND
```
    The index value when an element is not found in a list or array: -1. This value is returned by methods in this class and can also be used in comparisons with values returned by various method from List.
    
    See Also:
    Constant Field Values
- Constructor Detail
  - ArrayUtils
```
public ArrayUtils()
```
    ArrayUtils instances should NOT be constructed in standard programming. Instead, the class should be used as ArrayUtils.clone(new int[] {2}).
    
    This constructor is public to permit tools that require a JavaBean instance to operate.
- Method Detail
  - toMap
```
public static Map<Object,Object> toMap(Object[] array)
```
    Converts the given array into a Map. Each element of the array must be either a Map.Entry or an Array, containing at least two elements, where the first element is used as key and the second as value.
    
    This method can be used to initialize:
```
 // Create a Map mapping colors.
 Map colorMap = MapUtils.toMap(new String[][] {{
     {"RED", "#FF0000"},
     {"GREEN", "#00FF00"},
     {"BLUE", "#0000FF"}});
 
```
    This method returns null for a null input array.
    Parameters:
    array - an array whose elements are either a Map.Entry or an Array containing at least two elements, may be null
    
    Returns:
    a Map that was created from the array
    
    Throws:
    
    IllegalArgumentException - if one element of this Array is itself an Array containing less then two elements
    
    IllegalArgumentException - if the array contains elements other than Map.Entry and an Array
  - nullToEmpty
```
public static Object[] nullToEmpty(Object[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static Class<?>[] nullToEmpty(Class<?>[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    3.2
  - nullToEmpty
```
public static String[] nullToEmpty(String[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static long[] nullToEmpty(long[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static int[] nullToEmpty(int[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static short[] nullToEmpty(short[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static char[] nullToEmpty(char[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static byte[] nullToEmpty(byte[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static double[] nullToEmpty(double[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static float[] nullToEmpty(float[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static boolean[] nullToEmpty(boolean[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static Long[] nullToEmpty(Long[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static Integer[] nullToEmpty(Integer[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static Short[] nullToEmpty(Short[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static Character[] nullToEmpty(Character[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static Byte[] nullToEmpty(Byte[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static Double[] nullToEmpty(Double[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static Float[] nullToEmpty(Float[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - nullToEmpty
```
public static Boolean[] nullToEmpty(Boolean[] array)
```
    Defensive programming technique to change a null reference to an empty one.
    
    This method returns an empty array for a null input array.
    
    As a memory optimizing technique an empty array passed in will be overridden with the empty public static references in this class.
    
    Parameters:
    array - the array to check for null or empty
    
    Returns:
    the same array, public static empty array if null or empty input
    Since:
    
    2.5
  - subarray
```
public static long[] subarray(long[] array,
              int startIndexInclusive,
              int endIndexExclusive)
```
    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.
    
    Parameters:
    array - the array
    startIndexInclusive - 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
    
    See Also:
    Arrays.copyOfRange(long[], int, int)
  - subarray
```
public static int[] subarray(int[] array,
             int startIndexInclusive,
             int endIndexExclusive)
```
    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.
    
    Parameters:
    array - the array
    startIndexInclusive - 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
    
    See Also:
    Arrays.copyOfRange(int[], int, int)
  - subarray
```
public static short[] subarray(short[] array,
               int startIndexInclusive,
               int endIndexExclusive)
```
    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.
    
    Parameters:
    array - the array
    startIndexInclusive - 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
    
    See Also:
    Arrays.copyOfRange(short[], int, int)
  - subarray
```
public static char[] subarray(char[] array,
              int startIndexInclusive,
              int endIndexExclusive)
```
    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.
    
    Parameters:
    array - the array
    startIndexInclusive - 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
    
    See Also:
    Arrays.copyOfRange(char[], int, int)
  - subarray
```
public static byte[] subarray(byte[] array,
              int startIndexInclusive,
              int endIndexExclusive)
```
    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.
    
    Parameters:
    array - the array
    startIndexInclusive - 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
    
    See Also:
    Arrays.copyOfRange(byte[], int, int)
  - subarray
```
public static double[] subarray(double[] array,
                int startIndexInclusive,
                int endIndexExclusive)
```
    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.
    
    Parameters:
    array - the array
    startIndexInclusive - 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
    
    See Also:
    Arrays.copyOfRange(double[], int, int)
  - subarray
```
public static float[] subarray(float[] array,
               int startIndexInclusive,
               int endIndexExclusive)
```
    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.
    
    Parameters:
    array - the array
    startIndexInclusive - 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
    
    See Also:
    Arrays.copyOfRange(float[], int, int)
  - subarray
```
public static boolean[] subarray(boolean[] array,
                 int startIndexInclusive,
                 int endIndexExclusive)
```
    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.
    
    Parameters:
    array - the array
    startIndexInclusive - 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
    
    See Also:
    Arrays.copyOfRange(boolean[], int, int)
  - isSameLength
```
public static boolean isSameLength(Object[] array1,
                   Object[] array2)
```
    Checks whether two arrays are the same length, treating null arrays as length 0.
    Any multi-dimensional aspects of the arrays are ignored.
    
    Parameters:
    array1 - the first array, may be null
    array2 - the second array, may be null
    
    Returns:
    true if length of arrays matches, treating null as an empty array
  - isSameLength
```
public static boolean isSameLength(long[] array1,
                   long[] array2)
```
    Checks whether two arrays are the same length, treating null arrays as length 0 .
    
    Parameters:
    array1 - the first array, may be null
    array2 - the second array, may be null
    
    Returns:
    true if length of arrays matches, treating null as an empty array
  - isSameLength
```
public static boolean isSameLength(int[] array1,
                   int[] array2)
```
    Checks whether two arrays are the same length, treating null arrays as length 0 .
    
    Parameters:
    array1 - the first array, may be null
    array2 - the second array, may be null
    
    Returns:
    true if length of arrays matches, treating null as an empty array
  - isSameLength
```
public static boolean isSameLength(short[] array1,
                   short[] array2)
```
    Checks whether two arrays are the same length, treating null arrays as length 0 .
    
    Parameters:
    array1 - the first array, may be null
    array2 - the second array, may be null
    
    Returns:
    true if length of arrays matches, treating null as an empty array
  - isSameLength
```
public static boolean isSameLength(char[] array1,
                   char[] array2)
```
    Checks whether two arrays are the same length, treating null arrays as length 0 .
    
    Parameters:
    array1 - the first array, may be null
    array2 - the second array, may be null
    
    Returns:
    true if length of arrays matches, treating null as an empty array
  - isSameLength
```
public static boolean isSameLength(byte[] array1,
                   byte[] array2)
```
    Checks whether two arrays are the same length, treating null arrays as length 0 .
    
    Parameters:
    array1 - the first array, may be null
    array2 - the second array, may be null
    
    Returns:
    true if length of arrays matches, treating null as an empty array
  - isSameLength
```
public static boolean isSameLength(double[] array1,
                   double[] array2)
```
    Checks whether two arrays are the same length, treating null arrays as length 0 .
    
    Parameters:
    array1 - the first array, may be null
    array2 - the second array, may be null
    
    Returns:
    true if length of arrays matches, treating null as an empty array
  - isSameLength
```
public static boolean isSameLength(float[] array1,
                   float[] array2)
```
    Checks whether two arrays are the same length, treating null arrays as length 0 .
    
    Parameters:
    array1 - the first array, may be null
    array2 - the second array, may be null
    
    Returns:
    true if length of arrays matches, treating null as an empty array
  - isSameLength
```
public static boolean isSameLength(boolean[] array1,
                   boolean[] array2)
```
    Checks whether two arrays are the same length, treating null arrays as length 0 .
    
    Parameters:
    array1 - the first array, may be null
    array2 - the second array, may be null
    
    Returns:
    true if length of arrays matches, treating null as an empty array
  - isSameType
```
public static boolean isSameType(Object array1,
                 Object array2)
```
    Checks whether two arrays are the same type taking into account multi-dimensional arrays.
    
    Parameters:
    array1 - the first array, must not be null
    array2 - the second array, must not be null
    
    Returns:
    true if type of arrays matches
    
    Throws:
    
    IllegalArgumentException - if either array is null
  - reverse
```
public static void reverse(Object[] array)
```
    Reverses the order of the given array.
    
    There is no special handling for multi-dimensional arrays.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
  - reverse
```
public static void reverse(long[] array)
```
    Reverses the order of the given array.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
  - reverse
```
public static void reverse(int[] array)
```
    Reverses the order of the given array.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
  - reverse
```
public static void reverse(short[] array)
```
    Reverses the order of the given array.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
  - reverse
```
public static void reverse(char[] array)
```
    Reverses the order of the given array.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
  - reverse
```
public static void reverse(byte[] array)
```
    Reverses the order of the given array.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
  - reverse
```
public static void reverse(double[] array)
```
    Reverses the order of the given array.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
  - reverse
```
public static void reverse(float[] array)
```
    Reverses the order of the given array.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
  - reverse
```
public static void reverse(boolean[] array)
```
    Reverses the order of the given array.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
  - reverse
```
public static void reverse(boolean[] array,
           int startIndexInclusive,
           int endIndexExclusive)
```
    Reverses the order of the given array in the given range.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
    startIndexInclusive - the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in no change.
    endIndexExclusive - elements up to endIndex-1 are reversed in the array. Undervalue (< start index) results in no change. Overvalue (>array.length) is demoted to array length.
    Since:
    
    3.2
  - reverse
```
public static void reverse(byte[] array,
           int startIndexInclusive,
           int endIndexExclusive)
```
    Reverses the order of the given array in the given range.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
    startIndexInclusive - the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in no change.
    endIndexExclusive - elements up to endIndex-1 are reversed in the array. Undervalue (< start index) results in no change. Overvalue (>array.length) is demoted to array length.
    Since:
    
    3.2
  - reverse
```
public static void reverse(char[] array,
           int startIndexInclusive,
           int endIndexExclusive)
```
    Reverses the order of the given array in the given range.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
    startIndexInclusive - the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in no change.
    endIndexExclusive - elements up to endIndex-1 are reversed in the array. Undervalue (< start index) results in no change. Overvalue (>array.length) is demoted to array length.
    Since:
    
    3.2
  - reverse
```
public static void reverse(double[] array,
           int startIndexInclusive,
           int endIndexExclusive)
```
    Reverses the order of the given array in the given range.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
    startIndexInclusive - the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in no change.
    endIndexExclusive - elements up to endIndex-1 are reversed in the array. Undervalue (< start index) results in no change. Overvalue (>array.length) is demoted to array length.
    Since:
    
    3.2
  - reverse
```
public static void reverse(float[] array,
           int startIndexInclusive,
           int endIndexExclusive)
```
    Reverses the order of the given array in the given range.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
    startIndexInclusive - the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in no change.
    endIndexExclusive - elements up to endIndex-1 are reversed in the array. Undervalue (< start index) results in no change. Overvalue (>array.length) is demoted to array length.
    Since:
    
    3.2
  - reverse
```
public static void reverse(int[] array,
           int startIndexInclusive,
           int endIndexExclusive)
```
    Reverses the order of the given array in the given range.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
    startIndexInclusive - the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in no change.
    endIndexExclusive - elements up to endIndex-1 are reversed in the array. Undervalue (< start index) results in no change. Overvalue (>array.length) is demoted to array length.
    Since:
    
    3.2
  - reverse
```
public static void reverse(long[] array,
           int startIndexInclusive,
           int endIndexExclusive)
```
    Reverses the order of the given array in the given range.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
    startIndexInclusive - the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in no change.
    endIndexExclusive - elements up to endIndex-1 are reversed in the array. Undervalue (< start index) results in no change. Overvalue (>array.length) is demoted to array length.
    Since:
    
    3.2
  - reverse
```
public static void reverse(Object[] array,
           int startIndexInclusive,
           int endIndexExclusive)
```
    Reverses the order of the given array in the given range.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
    startIndexInclusive - the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in no change.
    endIndexExclusive - elements up to endIndex-1 are reversed in the array. Undervalue (< start index) results in no change. Overvalue (>array.length) is demoted to array length.
    Since:
    
    3.2
  - reverse
```
public static void reverse(short[] array,
           int startIndexInclusive,
           int endIndexExclusive)
```
    Reverses the order of the given array in the given range.
    
    This method does nothing for a null input array.
    
    Parameters:
    array - the array to reverse, may be null
    startIndexInclusive - the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in no change.
    endIndexExclusive - elements up to endIndex-1 are reversed in the array. Undervalue (< start index) results in no change. Overvalue (>array.length) is demoted to array length.
    Since:
    
    3.2
  - indexOf
```
public static int indexOf(long[] array,
          long valueToFind)
```
    Finds the index of the given value in the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - indexOf
```
public static int indexOf(long[] array,
          long valueToFind,
          int startIndex)
```
    Finds the index of the given value in the array starting at the given index.
    
    This method returns 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 INDEX_NOT_FOUND (-1).
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    startIndex - the index to start searching at
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(long[] array,
              long valueToFind)
```
    Finds the last index of the given value within the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to travers backwords looking for the object, may be null
    valueToFind - the object to find
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(long[] array,
              long valueToFind,
              int startIndex)
```
    Finds the last index of the given value in the array starting at the given index.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    A negative startIndex will return INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.
    
    Parameters:
    array - the array to traverse for looking for the object, may be null
    valueToFind - the value to find
    startIndex - the start index to travers backwards from
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - contains
```
public static boolean contains(long[] array,
               long valueToFind)
```
    Checks if the value is in the given array.
    
    The method returns false if a null array is passed in.
    
    Parameters:
    array - the array to search through
    valueToFind - the value to find
    
    Returns:
    true if the array contains the object
  - indexOf
```
public static int indexOf(int[] array,
          int valueToFind)
```
    Finds the index of the given value in the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - indexOf
```
public static int indexOf(int[] array,
          int valueToFind,
          int startIndex)
```
    Finds the index of the given value in the array starting at the given index.
    
    This method returns 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 INDEX_NOT_FOUND (-1).
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    startIndex - the index to start searching at
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(int[] array,
              int valueToFind)
```
    Finds the last index of the given value within the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to travers backwords looking for the object, may be null
    valueToFind - the object to find
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(int[] array,
              int valueToFind,
              int startIndex)
```
    Finds the last index of the given value in the array starting at the given index.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    A negative startIndex will return INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.
    
    Parameters:
    array - the array to traverse for looking for the object, may be null
    valueToFind - the value to find
    startIndex - the start index to travers backwards from
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - contains
```
public static boolean contains(int[] array,
               int valueToFind)
```
    Checks if the value is in the given array.
    
    The method returns false if a null array is passed in.
    
    Parameters:
    array - the array to search through
    valueToFind - the value to find
    
    Returns:
    true if the array contains the object
  - indexOf
```
public static int indexOf(short[] array,
          short valueToFind)
```
    Finds the index of the given value in the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - indexOf
```
public static int indexOf(short[] array,
          short valueToFind,
          int startIndex)
```
    Finds the index of the given value in the array starting at the given index.
    
    This method returns 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 INDEX_NOT_FOUND (-1).
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    startIndex - the index to start searching at
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(short[] array,
              short valueToFind)
```
    Finds the last index of the given value within the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to travers backwords looking for the object, may be null
    valueToFind - the object to find
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(short[] array,
              short valueToFind,
              int startIndex)
```
    Finds the last index of the given value in the array starting at the given index.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    A negative startIndex will return INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.
    
    Parameters:
    array - the array to traverse for looking for the object, may be null
    valueToFind - the value to find
    startIndex - the start index to travers backwards from
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - contains
```
public static boolean contains(short[] array,
               short valueToFind)
```
    Checks if the value is in the given array.
    
    The method returns false if a null array is passed in.
    
    Parameters:
    array - the array to search through
    valueToFind - the value to find
    
    Returns:
    true if the array contains the object
  - indexOf
```
public static int indexOf(char[] array,
          char valueToFind)
```
    Finds the index of the given value in the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
    Since:
    
    2.1
  - indexOf
```
public static int indexOf(char[] array,
          char valueToFind,
          int startIndex)
```
    Finds the index of the given value in the array starting at the given index.
    
    This method returns 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 INDEX_NOT_FOUND (-1).
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    startIndex - the index to start searching at
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
    Since:
    
    2.1
  - lastIndexOf
```
public static int lastIndexOf(char[] array,
              char valueToFind)
```
    Finds the last index of the given value within the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to travers backwords looking for the object, may be null
    valueToFind - the object to find
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
    Since:
    
    2.1
  - lastIndexOf
```
public static int lastIndexOf(char[] array,
              char valueToFind,
              int startIndex)
```
    Finds the last index of the given value in the array starting at the given index.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    A negative startIndex will return INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.
    
    Parameters:
    array - the array to traverse for looking for the object, may be null
    valueToFind - the value to find
    startIndex - the start index to travers backwards from
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
    Since:
    
    2.1
  - contains
```
public static boolean contains(char[] array,
               char valueToFind)
```
    Checks if the value is in the given array.
    
    The method returns false if a null array is passed in.
    
    Parameters:
    array - the array to search through
    valueToFind - the value to find
    
    Returns:
    true if the array contains the object
    Since:
    
    2.1
  - indexOf
```
public static int indexOf(byte[] array,
          byte valueToFind)
```
    Finds the index of the given value in the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - indexOf
```
public static int indexOf(byte[] array,
          byte valueToFind,
          int startIndex)
```
    Finds the index of the given value in the array starting at the given index.
    
    This method returns 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 INDEX_NOT_FOUND (-1).
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    startIndex - the index to start searching at
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(byte[] array,
              byte valueToFind)
```
    Finds the last index of the given value within the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to travers backwords looking for the object, may be null
    valueToFind - the object to find
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(byte[] array,
              byte valueToFind,
              int startIndex)
```
    Finds the last index of the given value in the array starting at the given index.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    A negative startIndex will return INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.
    
    Parameters:
    array - the array to traverse for looking for the object, may be null
    valueToFind - the value to find
    startIndex - the start index to travers backwards from
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - contains
```
public static boolean contains(byte[] array,
               byte valueToFind)
```
    Checks if the value is in the given array.
    
    The method returns false if a null array is passed in.
    
    Parameters:
    array - the array to search through
    valueToFind - the value to find
    
    Returns:
    true if the array contains the object
  - indexOf
```
public static int indexOf(double[] array,
          double valueToFind)
```
    Finds the index of the given value in the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - indexOf
```
public static int indexOf(double[] array,
          double valueToFind,
          double tolerance)
```
    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 INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    tolerance - tolerance of the search
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - indexOf
```
public static int indexOf(double[] array,
          double valueToFind,
          int startIndex)
```
    Finds the index of the given value in the array starting at the given index.
    
    This method returns 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 INDEX_NOT_FOUND (-1).
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    startIndex - the index to start searching at
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - indexOf
```
public static int indexOf(double[] array,
          double valueToFind,
          int startIndex,
          double tolerance)
```
    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 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 INDEX_NOT_FOUND (-1).
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    startIndex - the index to start searching at
    tolerance - tolerance of the search
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(double[] array,
              double valueToFind)
```
    Finds the last index of the given value within the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to travers backwords looking for the object, may be null
    valueToFind - the object to find
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(double[] array,
              double valueToFind,
              double tolerance)
```
    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 INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    tolerance - tolerance of the search
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(double[] array,
              double valueToFind,
              int startIndex)
```
    Finds the last index of the given value in the array starting at the given index.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    A negative startIndex will return INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.
    
    Parameters:
    array - the array to traverse for looking for the object, may be null
    valueToFind - the value to find
    startIndex - the start index to travers backwards from
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(double[] array,
              double valueToFind,
              int startIndex,
              double tolerance)
```
    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 INDEX_NOT_FOUND (-1) for a null input array.
    
    A negative startIndex will return INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.
    
    Parameters:
    array - the array to traverse for looking for the object, may be null
    valueToFind - the value to find
    startIndex - the start index to travers backwards from
    tolerance - search for value within plus/minus this amount
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - contains
```
public static boolean contains(double[] array,
               double valueToFind)
```
    Checks if the value is in the given array.
    
    The method returns false if a null array is passed in.
    
    Parameters:
    array - the array to search through
    valueToFind - the value to find
    
    Returns:
    true if the array contains the object
  - contains
```
public static boolean contains(double[] array,
               double valueToFind,
               double tolerance)
```
    Checks if a value falling within the given tolerance is in the given array. If the array contains a value within the inclusive range defined by (value - tolerance) to (value + tolerance).
    
    The method returns false if a null array is passed in.
    
    Parameters:
    array - the array to search
    valueToFind - the value to find
    tolerance - the array contains the tolerance of the search
    
    Returns:
    true if value falling within tolerance is in array
  - indexOf
```
public static int indexOf(float[] array,
          float valueToFind)
```
    Finds the index of the given value in the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - indexOf
```
public static int indexOf(float[] array,
          float valueToFind,
          int startIndex)
```
    Finds the index of the given value in the array starting at the given index.
    
    This method returns 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 INDEX_NOT_FOUND (-1).
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    startIndex - the index to start searching at
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(float[] array,
              float valueToFind)
```
    Finds the last index of the given value within the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to travers backwords looking for the object, may be null
    valueToFind - the object to find
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(float[] array,
              float valueToFind,
              int startIndex)
```
    Finds the last index of the given value in the array starting at the given index.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    A negative startIndex will return INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.
    
    Parameters:
    array - the array to traverse for looking for the object, may be null
    valueToFind - the value to find
    startIndex - the start index to travers backwards from
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - contains
```
public static boolean contains(float[] array,
               float valueToFind)
```
    Checks if the value is in the given array.
    
    The method returns false if a null array is passed in.
    
    Parameters:
    array - the array to search through
    valueToFind - the value to find
    
    Returns:
    true if the array contains the object
  - indexOf
```
public static int indexOf(boolean[] array,
          boolean valueToFind)
```
    Finds the index of the given value in the array.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - indexOf
```
public static int indexOf(boolean[] array,
          boolean valueToFind,
          int startIndex)
```
    Finds the index of the given value in the array starting at the given index.
    
    This method returns 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 INDEX_NOT_FOUND (-1).
    
    Parameters:
    array - the array to search through for the object, may be null
    valueToFind - the value to find
    startIndex - the index to start searching at
    
    Returns:
    the index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(boolean[] array,
              boolean valueToFind)
```
    Finds the last index of the given value within the array.
    
    This method returns INDEX_NOT_FOUND (-1) if null array input.
    
    Parameters:
    array - the array to travers backwords looking for the object, may be null
    valueToFind - the object to find
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - lastIndexOf
```
public static int lastIndexOf(boolean[] array,
              boolean valueToFind,
              int startIndex)
```
    Finds the last index of the given value in the array starting at the given index.
    
    This method returns INDEX_NOT_FOUND (-1) for a null input array.
    
    A negative startIndex will return INDEX_NOT_FOUND (-1). A startIndex larger than the array length will search from the end of the array.
    
    Parameters:
    array - the array to traverse for looking for the object, may be null
    valueToFind - the value to find
    startIndex - the start index to travers backwards from
    
    Returns:
    the last index of the value within the array, INDEX_NOT_FOUND (-1) if not found or null array input
  - contains
```
public static boolean contains(boolean[] array,
               boolean valueToFind)
```
    Checks if the value is in the given array.
    
    The method returns false if a null array is passed in.
    
    Parameters:
    array - the array to search through
    valueToFind - the value to find
    
    Returns:
    true if the array contains the object
  - toPrimitive
```
public static char[] toPrimitive(Character[] array)
```
    Converts an array of object Characters to primitives.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Character array, may be null
    
    Returns:
    a char array, null if null array input
    
    Throws:
    
    NullPointerException - if array content is null
  - toPrimitive
```
public static char[] toPrimitive(Character[] array,
                 char valueForNull)
```
    Converts an array of object Character to primitives handling null.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Character array, may be null
    valueForNull - the value to insert if null found
    
    Returns:
    a char array, null if null array input
  - toObject
```
public static Character[] toObject(char[] array)
```
    Converts an array of primitive chars to objects.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a char array
    
    Returns:
    a Character array, null if null array input
  - toPrimitive
```
public static long[] toPrimitive(Long[] array)
```
    Converts an array of object Longs to primitives.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Long array, may be null
    
    Returns:
    a long array, null if null array input
    
    Throws:
    
    NullPointerException - if array content is null
  - toPrimitive
```
public static long[] toPrimitive(Long[] array,
                 long valueForNull)
```
    Converts an array of object Long to primitives handling null.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Long array, may be null
    valueForNull - the value to insert if null found
    
    Returns:
    a long array, null if null array input
  - toObject
```
public static Long[] toObject(long[] array)
```
    Converts an array of primitive longs to objects.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a long array
    
    Returns:
    a Long array, null if null array input
  - toPrimitive
```
public static int[] toPrimitive(Integer[] array)
```
    Converts an array of object Integers to primitives.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Integer array, may be null
    
    Returns:
    an int array, null if null array input
    
    Throws:
    
    NullPointerException - if array content is null
  - toPrimitive
```
public static int[] toPrimitive(Integer[] array,
                int valueForNull)
```
    Converts an array of object Integer to primitives handling null.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Integer array, may be null
    valueForNull - the value to insert if null found
    
    Returns:
    an int array, null if null array input
  - toObject
```
public static Integer[] toObject(int[] array)
```
    Converts an array of primitive ints to objects.
    
    This method returns null for a null input array.
    
    Parameters:
    array - an int array
    
    Returns:
    an Integer array, null if null array input
  - toPrimitive
```
public static short[] toPrimitive(Short[] array)
```
    Converts an array of object Shorts to primitives.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Short array, may be null
    
    Returns:
    a byte array, null if null array input
    
    Throws:
    
    NullPointerException - if array content is null
  - toPrimitive
```
public static short[] toPrimitive(Short[] array,
                  short valueForNull)
```
    Converts an array of object Short to primitives handling null.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Short array, may be null
    valueForNull - the value to insert if null found
    
    Returns:
    a byte array, null if null array input
  - toObject
```
public static Short[] toObject(short[] array)
```
    Converts an array of primitive shorts to objects.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a short array
    
    Returns:
    a Short array, null if null array input
  - toPrimitive
```
public static byte[] toPrimitive(Byte[] array)
```
    Converts an array of object Bytes to primitives.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Byte array, may be null
    
    Returns:
    a byte array, null if null array input
    
    Throws:
    
    NullPointerException - if array content is null
  - toPrimitive
```
public static byte[] toPrimitive(Byte[] array,
                 byte valueForNull)
```
    Converts an array of object Bytes to primitives handling null.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Byte array, may be null
    valueForNull - the value to insert if null found
    
    Returns:
    a byte array, null if null array input
  - toObject
```
public static Byte[] toObject(byte[] array)
```
    Converts an array of primitive bytes to objects.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a byte array
    
    Returns:
    a Byte array, null if null array input
  - toPrimitive
```
public static double[] toPrimitive(Double[] array)
```
    Converts an array of object Doubles to primitives.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Double array, may be null
    
    Returns:
    a double array, null if null array input
    
    Throws:
    
    NullPointerException - if array content is null
  - toPrimitive
```
public static double[] toPrimitive(Double[] array,
                   double valueForNull)
```
    Converts an array of object Doubles to primitives handling null.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Double array, may be null
    valueForNull - the value to insert if null found
    
    Returns:
    a double array, null if null array input
  - toObject
```
public static Double[] toObject(double[] array)
```
    Converts an array of primitive doubles to objects.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a double array
    
    Returns:
    a Double array, null if null array input
  - toPrimitive
```
public static float[] toPrimitive(Float[] array)
```
    Converts an array of object Floats to primitives.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Float array, may be null
    
    Returns:
    a float array, null if null array input
    
    Throws:
    
    NullPointerException - if array content is null
  - toPrimitive
```
public static float[] toPrimitive(Float[] array,
                  float valueForNull)
```
    Converts an array of object Floats to primitives handling null.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Float array, may be null
    valueForNull - the value to insert if null found
    
    Returns:
    a float array, null if null array input
  - toObject
```
public static Float[] toObject(float[] array)
```
    Converts an array of primitive floats to objects.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a float array
    
    Returns:
    a Float array, null if null array input
  - toPrimitive
```
public static boolean[] toPrimitive(Boolean[] array)
```
    Converts an array of object Booleans to primitives.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Boolean array, may be null
    
    Returns:
    a boolean array, null if null array input
    
    Throws:
    
    NullPointerException - if array content is null
  - toPrimitive
```
public static boolean[] toPrimitive(Boolean[] array,
                    boolean valueForNull)
```
    Converts an array of object Booleans to primitives handling null.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a Boolean array, may be null
    valueForNull - the value to insert if null found
    
    Returns:
    a boolean array, null if null array input
  - toObject
```
public static Boolean[] toObject(boolean[] array)
```
    Converts an array of primitive booleans to objects.
    
    This method returns null for a null input array.
    
    Parameters:
    array - a boolean array
    
    Returns:
    a Boolean array, null if null array input
  - isEmpty
```
public static boolean isEmpty(Object[] array)
```
    Checks if an array of Objects is empty or null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is empty or null
    Since:
    
    2.1
  - isEmpty
```
public static boolean isEmpty(long[] array)
```
    Checks if an array of primitive longs is empty or null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is empty or null
    Since:
    
    2.1
  - isEmpty
```
public static boolean isEmpty(int[] array)
```
    Checks if an array of primitive ints is empty or null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is empty or null
    Since:
    
    2.1
  - isEmpty
```
public static boolean isEmpty(short[] array)
```
    Checks if an array of primitive shorts is empty or null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is empty or null
    Since:
    
    2.1
  - isEmpty
```
public static boolean isEmpty(char[] array)
```
    Checks if an array of primitive chars is empty or null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is empty or null
    Since:
    
    2.1
  - isEmpty
```
public static boolean isEmpty(byte[] array)
```
    Checks if an array of primitive bytes is empty or null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is empty or null
    Since:
    
    2.1
  - isEmpty
```
public static boolean isEmpty(double[] array)
```
    Checks if an array of primitive doubles is empty or null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is empty or null
    Since:
    
    2.1
  - isEmpty
```
public static boolean isEmpty(float[] array)
```
    Checks if an array of primitive floats is empty or null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is empty or null
    Since:
    
    2.1
  - isEmpty
```
public static boolean isEmpty(boolean[] array)
```
    Checks if an array of primitive booleans is empty or null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is empty or null
    Since:
    
    2.1
  - isNotEmpty
```
public static <T> boolean isNotEmpty(T[] array)
```
    Checks if an array of Objects is not empty or not null.
    
    Type Parameters:
    T - the component type of the array
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is not empty or not null
    Since:
    
    2.5
  - isNotEmpty
```
public static boolean isNotEmpty(long[] array)
```
    Checks if an array of primitive longs is not empty or not null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is not empty or not null
    Since:
    
    2.5
  - isNotEmpty
```
public static boolean isNotEmpty(int[] array)
```
    Checks if an array of primitive ints is not empty or not null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is not empty or not null
    Since:
    
    2.5
  - isNotEmpty
```
public static boolean isNotEmpty(short[] array)
```
    Checks if an array of primitive shorts is not empty or not null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is not empty or not null
    Since:
    
    2.5
  - isNotEmpty
```
public static boolean isNotEmpty(char[] array)
```
    Checks if an array of primitive chars is not empty or not null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is not empty or not null
    Since:
    
    2.5
  - isNotEmpty
```
public static boolean isNotEmpty(byte[] array)
```
    Checks if an array of primitive bytes is not empty or not null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is not empty or not null
    Since:
    
    2.5
  - isNotEmpty
```
public static boolean isNotEmpty(double[] array)
```
    Checks if an array of primitive doubles is not empty or not null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is not empty or not null
    Since:
    
    2.5
  - isNotEmpty
```
public static boolean isNotEmpty(float[] array)
```
    Checks if an array of primitive floats is not empty or not null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is not empty or not null
    Since:
    
    2.5
  - isNotEmpty
```
public static boolean isNotEmpty(boolean[] array)
```
    Checks if an array of primitive booleans is not empty or not null.
    
    Parameters:
    array - the array to test
    
    Returns:
    true if the array is not empty or not null
    Since:
    
    2.5

Class ArrayUtils

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EMPTY_OBJECT_ARRAY

EMPTY_CLASS_ARRAY

EMPTY_STRING_ARRAY

EMPTY_LONG_ARRAY

EMPTY_LONG_OBJECT_ARRAY

EMPTY_INT_ARRAY

EMPTY_INTEGER_OBJECT_ARRAY

EMPTY_SHORT_ARRAY

EMPTY_SHORT_OBJECT_ARRAY

EMPTY_BYTE_ARRAY

EMPTY_BYTE_OBJECT_ARRAY

EMPTY_DOUBLE_ARRAY

EMPTY_DOUBLE_OBJECT_ARRAY

EMPTY_FLOAT_ARRAY

EMPTY_FLOAT_OBJECT_ARRAY

EMPTY_BOOLEAN_ARRAY

EMPTY_BOOLEAN_OBJECT_ARRAY

EMPTY_CHAR_ARRAY

EMPTY_CHARACTER_OBJECT_ARRAY

INDEX_NOT_FOUND

Constructor Detail

ArrayUtils

Method Detail

toMap

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

nullToEmpty

subarray

subarray

subarray

subarray

subarray

subarray

subarray

subarray

isSameLength

isSameLength

isSameLength

isSameLength

isSameLength

isSameLength

isSameLength

isSameLength

isSameLength

isSameType

reverse

reverse

reverse

reverse

reverse

reverse

reverse

reverse

reverse

reverse

reverse

reverse

reverse