net.tsz.afinal.core
类 Arrays

java.lang.Object
  net.tsz.afinal.core.Arrays

public class Arrays
extends java.lang.Object

Arrays contains static methods which operate on arrays.

从以下版本开始：

1.2

方法摘要

static <T> java.util.List<T>	asList(T... array) Returns a List of the objects in the specified array.
static int	binarySearch(byte[] array, byte value) Performs a binary search for value in the ascending sorted array array.
static int	binarySearch(byte[] array, int startIndex, int endIndex, byte value) Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive).
static int	binarySearch(char[] array, char value) Performs a binary search for value in the ascending sorted array array.
static int	binarySearch(char[] array, int startIndex, int endIndex, char value) Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive).
static int	binarySearch(double[] array, double value) Performs a binary search for value in the ascending sorted array array.
static int	binarySearch(double[] array, int startIndex, int endIndex, double value) Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive).
static int	binarySearch(float[] array, float value) Performs a binary search for value in the ascending sorted array array.
static int	binarySearch(float[] array, int startIndex, int endIndex, float value) Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive).
static int	binarySearch(int[] array, int value) Performs a binary search for value in the ascending sorted array array.
static int	binarySearch(int[] array, int startIndex, int endIndex, int value) Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive).
static int	binarySearch(long[] array, int startIndex, int endIndex, long value) Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive).
static int	binarySearch(long[] array, long value) Performs a binary search for value in the ascending sorted array array.
static int	binarySearch(java.lang.Object[] array, int startIndex, int endIndex, java.lang.Object value) Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive).
static int	binarySearch(java.lang.Object[] array, java.lang.Object value) Performs a binary search for value in the ascending sorted array array.
static int	binarySearch(short[] array, int startIndex, int endIndex, short value) Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive).
static int	binarySearch(short[] array, short value) Performs a binary search for value in the ascending sorted array array.
static <T> int	binarySearch(T[] array, int startIndex, int endIndex, T value, java.util.Comparator<? super T> comparator) Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive), using comparator to compare elements.
static <T> int	binarySearch(T[] array, T value, java.util.Comparator<? super T> comparator) Performs a binary search for value in the ascending sorted array array, using comparator to compare elements.
static boolean[]	copyOf(boolean[] original, int newLength) Copies newLength elements from original into a new array.
static byte[]	copyOf(byte[] original, int newLength) Copies newLength elements from original into a new array.
static char[]	copyOf(char[] original, int newLength) Copies newLength elements from original into a new array.
static double[]	copyOf(double[] original, int newLength) Copies newLength elements from original into a new array.
static float[]	copyOf(float[] original, int newLength) Copies newLength elements from original into a new array.
static int[]	copyOf(int[] original, int newLength) Copies newLength elements from original into a new array.
static long[]	copyOf(long[] original, int newLength) Copies newLength elements from original into a new array.
static short[]	copyOf(short[] original, int newLength) Copies newLength elements from original into a new array.
static <T> T[]	copyOf(T[] original, int newLength) Copies newLength elements from original into a new array.
static <T,U> T[]	copyOf(U[] original, int newLength, java.lang.Class<? extends T[]> newType) Copies newLength elements from original into a new array.
static boolean[]	copyOfRange(boolean[] original, int start, int end) Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive).
static byte[]	copyOfRange(byte[] original, int start, int end) Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive).
static char[]	copyOfRange(char[] original, int start, int end) Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive).
static double[]	copyOfRange(double[] original, int start, int end) Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive).
static float[]	copyOfRange(float[] original, int start, int end) Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive).
static int[]	copyOfRange(int[] original, int start, int end) Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive).
static long[]	copyOfRange(long[] original, int start, int end) Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive).
static short[]	copyOfRange(short[] original, int start, int end) Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive).
static <T> T[]	copyOfRange(T[] original, int start, int end) Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive).
static <T,U> T[]	copyOfRange(U[] original, int start, int end, java.lang.Class<? extends T[]> newType) Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive).
static boolean	deepEquals(java.lang.Object[] array1, java.lang.Object[] array2) Returns true if the two given arrays are deeply equal to one another.
static int	deepHashCode(java.lang.Object[] array) Returns a hash code based on the "deep contents" of the given array.
static java.lang.String	deepToString(java.lang.Object[] array) Creates a "deep" String representation of the Object[] passed, such that if the array contains other arrays, the String representation of those arrays is generated as well.
static boolean	equals(boolean[] array1, boolean[] array2) Compares the two arrays.
static boolean	equals(byte[] array1, byte[] array2) Compares the two arrays.
static boolean	equals(char[] array1, char[] array2) Compares the two arrays.
static boolean	equals(double[] array1, double[] array2) Compares the two arrays.
static boolean	equals(float[] array1, float[] array2) Compares the two arrays.
static boolean	equals(int[] array1, int[] array2) Compares the two arrays.
static boolean	equals(long[] array1, long[] array2) Compares the two arrays.
static boolean	equals(java.lang.Object[] array1, java.lang.Object[] array2) Compares the two arrays.
static boolean	equals(short[] array1, short[] array2) Compares the two arrays.
static void	fill(boolean[] array, boolean value) Fills the specified array with the specified element.
static void	fill(byte[] array, byte value) Fills the specified array with the specified element.
static void	fill(int[] array, int value) Fills the specified array with the specified element.
static void	fill(java.lang.Object[] array, java.lang.Object value) Fills the specified array with the specified element.
static int	hashCode(boolean[] array) Returns a hash code based on the contents of the given array.
static int	hashCode(byte[] array) Returns a hash code based on the contents of the given array.
static int	hashCode(char[] array) Returns a hash code based on the contents of the given array.
static int	hashCode(double[] array) Returns a hash code based on the contents of the given array.
static int	hashCode(float[] array) Returns a hash code based on the contents of the given array.
static int	hashCode(int[] array) Returns a hash code based on the contents of the given array.
static int	hashCode(long[] array) Returns a hash code based on the contents of the given array.
static int	hashCode(java.lang.Object[] array) Returns a hash code based on the contents of the given array.
static int	hashCode(short[] array) Returns a hash code based on the contents of the given array.
static java.lang.String	toString(boolean[] array) Creates a String representation of the boolean[] passed.
static java.lang.String	toString(byte[] array) Creates a String representation of the byte[] passed.
static java.lang.String	toString(char[] array) Creates a String representation of the char[] passed.
static java.lang.String	toString(double[] array) Creates a String representation of the double[] passed.
static java.lang.String	toString(float[] array) Creates a String representation of the float[] passed.
static java.lang.String	toString(int[] array) Creates a String representation of the int[] passed.
static java.lang.String	toString(long[] array) Creates a String representation of the long[] passed.
static java.lang.String	toString(java.lang.Object[] array) Creates a String representation of the Object[] passed.
static java.lang.String	toString(short[] array) Creates a String representation of the short[] passed.

从类 java.lang.Object 继承的方法

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

方法详细信息

asList

public static <T> java.util.List<T> asList(T... array)

Returns a List of the objects in the specified array. The size of the List cannot be modified, i.e. adding and removing are unsupported, but the elements can be set. Setting an element modifies the underlying array.

参数：

array - the array.

返回：

a List of the elements of the specified array.

binarySearch

public static int binarySearch(byte[] array,
                               byte value)

Performs a binary search for value in the ascending sorted array array. Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

binarySearch

public static int binarySearch(byte[] array,
                               int startIndex,
                               int endIndex,
                               byte value)

Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive). Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

startIndex - the inclusive start index.

endIndex - the exclusive start index.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.IllegalArgumentException - if startIndex > endIndex

java.lang.ArrayIndexOutOfBoundsException - if startIndex < 0 || endIndex > array.length

从以下版本开始：

1.6

binarySearch

public static int binarySearch(char[] array,
                               char value)

Performs a binary search for value in the ascending sorted array array. Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

binarySearch

public static int binarySearch(char[] array,
                               int startIndex,
                               int endIndex,
                               char value)

Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive). Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

startIndex - the inclusive start index.

endIndex - the exclusive start index.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.IllegalArgumentException - if startIndex > endIndex

java.lang.ArrayIndexOutOfBoundsException - if startIndex < 0 || endIndex > array.length

从以下版本开始：

1.6

binarySearch

public static int binarySearch(double[] array,
                               double value)

Performs a binary search for value in the ascending sorted array array. Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

binarySearch

public static int binarySearch(double[] array,
                               int startIndex,
                               int endIndex,
                               double value)

Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive). Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

startIndex - the inclusive start index.

endIndex - the exclusive start index.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.IllegalArgumentException - if startIndex > endIndex

java.lang.ArrayIndexOutOfBoundsException - if startIndex < 0 || endIndex > array.length

从以下版本开始：

1.6

binarySearch

public static int binarySearch(float[] array,
                               float value)

Performs a binary search for value in the ascending sorted array array. Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

binarySearch

public static int binarySearch(float[] array,
                               int startIndex,
                               int endIndex,
                               float value)

Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive). Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

startIndex - the inclusive start index.

endIndex - the exclusive start index.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.IllegalArgumentException - if startIndex > endIndex

java.lang.ArrayIndexOutOfBoundsException - if startIndex < 0 || endIndex > array.length

从以下版本开始：

1.6

binarySearch

public static int binarySearch(int[] array,
                               int value)

Performs a binary search for value in the ascending sorted array array. Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

binarySearch

public static int binarySearch(int[] array,
                               int startIndex,
                               int endIndex,
                               int value)

Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive). Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

startIndex - the inclusive start index.

endIndex - the exclusive start index.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.IllegalArgumentException - if startIndex > endIndex

java.lang.ArrayIndexOutOfBoundsException - if startIndex < 0 || endIndex > array.length

从以下版本开始：

1.6

binarySearch

public static int binarySearch(long[] array,
                               long value)

Performs a binary search for value in the ascending sorted array array. Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

binarySearch

public static int binarySearch(long[] array,
                               int startIndex,
                               int endIndex,
                               long value)

Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive). Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

startIndex - the inclusive start index.

endIndex - the exclusive start index.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.IllegalArgumentException - if startIndex > endIndex

java.lang.ArrayIndexOutOfBoundsException - if startIndex < 0 || endIndex > array.length

从以下版本开始：

1.6

binarySearch

public static int binarySearch(java.lang.Object[] array,
                               java.lang.Object value)

Performs a binary search for value in the ascending sorted array array. Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.ClassCastException - if an element in the array or the search element does not implement Comparable, or cannot be compared to each other.

binarySearch

public static int binarySearch(java.lang.Object[] array,
                               int startIndex,
                               int endIndex,
                               java.lang.Object value)

Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive). Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

startIndex - the inclusive start index.

endIndex - the exclusive start index.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.ClassCastException - if an element in the array or the search element does not implement Comparable, or cannot be compared to each other.

java.lang.IllegalArgumentException - if startIndex > endIndex

java.lang.ArrayIndexOutOfBoundsException - if startIndex < 0 || endIndex > array.length

从以下版本开始：

1.6

binarySearch

public static <T> int binarySearch(T[] array,
                                   T value,
                                   java.util.Comparator<? super T> comparator)

Performs a binary search for value in the ascending sorted array array, using comparator to compare elements. Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

value - the element to find.

comparator - the Comparator used to compare the elements.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.ClassCastException - if an element in the array or the search element does not implement Comparable, or cannot be compared to each other.

binarySearch

public static <T> int binarySearch(T[] array,
                                   int startIndex,
                                   int endIndex,
                                   T value,
                                   java.util.Comparator<? super T> comparator)

Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive), using comparator to compare elements. Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

startIndex - the inclusive start index.

endIndex - the exclusive start index.

value - the element to find.

comparator - the Comparator used to compare the elements.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.ClassCastException - if an element in the array or the search element does not implement Comparable, or cannot be compared to each other.

java.lang.IllegalArgumentException - if startIndex > endIndex

java.lang.ArrayIndexOutOfBoundsException - if startIndex < 0 || endIndex > array.length

从以下版本开始：

1.6

binarySearch

public static int binarySearch(short[] array,
                               short value)

Performs a binary search for value in the ascending sorted array array. Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

binarySearch

public static int binarySearch(short[] array,
                               int startIndex,
                               int endIndex,
                               short value)

Performs a binary search for value in the ascending sorted array array, in the range specified by fromIndex (inclusive) and toIndex (exclusive). Searching in an unsorted array has an undefined result. It's also undefined which element is found if there are multiple occurrences of the same element.

参数：

array - the sorted array to search.

startIndex - the inclusive start index.

endIndex - the exclusive start index.

value - the element to find.

返回：

the non-negative index of the element, or a negative index which is -index - 1 where the element would be inserted.

抛出：

java.lang.IllegalArgumentException - if startIndex > endIndex

java.lang.ArrayIndexOutOfBoundsException - if startIndex < 0 || endIndex > array.length

从以下版本开始：

1.6

fill

public static void fill(byte[] array,
                        byte value)

Fills the specified array with the specified element.

参数：

array - the byte array to fill.

value - the byte element.

fill

public static void fill(int[] array,
                        int value)

Fills the specified array with the specified element.

参数：

array - the int array to fill.

value - the int element.

fill

public static void fill(boolean[] array,
                        boolean value)

Fills the specified array with the specified element.

参数：

array - the boolean array to fill.

value - the boolean element.

fill

public static void fill(java.lang.Object[] array,
                        java.lang.Object value)

Fills the specified array with the specified element.

参数：

array - the Object array to fill.

value - the Object element.

hashCode

public static int hashCode(boolean[] array)

Returns a hash code based on the contents of the given array. For any two boolean arrays a and b, if Arrays.equals(a, b) returns true, it means that the return value of Arrays.hashCode(a) equals Arrays.hashCode(b).

The value returned by this method is the same value as the List.hashCode() method which is invoked on a List containing a sequence of Boolean instances representing the elements of array in the same order. If the array is null, the return value is 0.

参数：

array - the array whose hash code to compute.

返回：

the hash code for array.

hashCode

public static int hashCode(int[] array)

Returns a hash code based on the contents of the given array. For any two not-null int arrays a and b, if Arrays.equals(a, b) returns true, it means that the return value of Arrays.hashCode(a) equals Arrays.hashCode(b).

The value returned by this method is the same value as the List.hashCode() method which is invoked on a List containing a sequence of Integer instances representing the elements of array in the same order. If the array is null, the return value is 0.

参数：

array - the array whose hash code to compute.

返回：

the hash code for array.

hashCode

public static int hashCode(short[] array)

Returns a hash code based on the contents of the given array. For any two short arrays a and b, if Arrays.equals(a, b) returns true, it means that the return value of Arrays.hashCode(a) equals Arrays.hashCode(b).

The value returned by this method is the same value as the List.hashCode() method which is invoked on a List containing a sequence of Short instances representing the elements of array in the same order. If the array is null, the return value is 0.

参数：

array - the array whose hash code to compute.

返回：

the hash code for array.

hashCode

public static int hashCode(char[] array)

Returns a hash code based on the contents of the given array. For any two char arrays a and b, if Arrays.equals(a, b) returns true, it means that the return value of Arrays.hashCode(a) equals Arrays.hashCode(b).

The value returned by this method is the same value as the List.hashCode() method which is invoked on a List containing a sequence of Character instances representing the elements of array in the same order. If the array is null, the return value is 0.

参数：

array - the array whose hash code to compute.

返回：

the hash code for array.

hashCode

public static int hashCode(byte[] array)

Returns a hash code based on the contents of the given array. For any two byte arrays a and b, if Arrays.equals(a, b) returns true, it means that the return value of Arrays.hashCode(a) equals Arrays.hashCode(b).

The value returned by this method is the same value as the List.hashCode() method which is invoked on a List containing a sequence of Byte instances representing the elements of array in the same order. If the array is null, the return value is 0.

参数：

array - the array whose hash code to compute.

返回：

the hash code for array.

hashCode

public static int hashCode(long[] array)

Returns a hash code based on the contents of the given array. For any two long arrays a and b, if Arrays.equals(a, b) returns true, it means that the return value of Arrays.hashCode(a) equals Arrays.hashCode(b).

The value returned by this method is the same value as the List.hashCode() method which is invoked on a List containing a sequence of Long instances representing the elements of array in the same order. If the array is null, the return value is 0.

参数：

array - the array whose hash code to compute.

返回：

the hash code for array.

hashCode

public static int hashCode(float[] array)

Returns a hash code based on the contents of the given array. For any two float arrays a and b, if Arrays.equals(a, b) returns true, it means that the return value of Arrays.hashCode(a) equals Arrays.hashCode(b).

The value returned by this method is the same value as the List.hashCode() method which is invoked on a List containing a sequence of Float instances representing the elements of array in the same order. If the array is null, the return value is 0.

参数：

array - the array whose hash code to compute.

返回：

the hash code for array.

hashCode

public static int hashCode(double[] array)

Returns a hash code based on the contents of the given array. For any two double arrays a and b, if Arrays.equals(a, b) returns true, it means that the return value of Arrays.hashCode(a) equals Arrays.hashCode(b).

The value returned by this method is the same value as the List.hashCode() method which is invoked on a List containing a sequence of Double instances representing the elements of array in the same order. If the array is null, the return value is 0.

参数：

array - the array whose hash code to compute.

返回：

the hash code for array.

hashCode

public static int hashCode(java.lang.Object[] array)

Returns a hash code based on the contents of the given array. If the array contains other arrays as its elements, the hash code is based on their identities not their contents. So it is acceptable to invoke this method on an array that contains itself as an element, either directly or indirectly.

For any two arrays a and b, if Arrays.equals(a, b) returns true, it means that the return value of Arrays.hashCode(a) equals Arrays.hashCode(b).

The value returned by this method is the same value as the method Arrays.asList(array).hashCode(). If the array is null, the return value is 0.

参数：

array - the array whose hash code to compute.

返回：

the hash code for array.

deepHashCode

public static int deepHashCode(java.lang.Object[] array)

Returns a hash code based on the "deep contents" of the given array. If the array contains other arrays as its elements, the hash code is based on their contents not their identities. So it is not acceptable to invoke this method on an array that contains itself as an element, either directly or indirectly.

For any two arrays a and b, if Arrays.deepEquals(a, b) returns true, it means that the return value of Arrays.deepHashCode(a) equals Arrays.deepHashCode(b).

The computation of the value returned by this method is similar to that of the value returned by List.hashCode() invoked on a List containing a sequence of instances representing the elements of array in the same order. The difference is: If an element e of array is itself an array, its hash code is computed by calling the appropriate overloading of Arrays.hashCode(e) if e is an array of a primitive type, or by calling Arrays.deepHashCode(e) recursively if e is an array of a reference type. The value returned by this method is the same value as the method Arrays.asList(array).hashCode(). If the array is null, the return value is 0.

参数：

array - the array whose hash code to compute.

返回：

the hash code for array.

equals

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

Compares the two arrays.

参数：

array1 - the first byte array.

array2 - the second byte array.

返回：

true if both arrays are null or if the arrays have the same length and the elements at each index in the two arrays are equal, false otherwise.

equals

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

Compares the two arrays.

参数：

array1 - the first short array.

array2 - the second short array.

返回：

true if both arrays are null or if the arrays have the same length and the elements at each index in the two arrays are equal, false otherwise.

equals

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

Compares the two arrays.

参数：

array1 - the first char array.

array2 - the second char array.

返回：

true if both arrays are null or if the arrays have the same length and the elements at each index in the two arrays are equal, false otherwise.

equals

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

Compares the two arrays.

参数：

array1 - the first int array.

array2 - the second int array.

返回：

true if both arrays are null or if the arrays have the same length and the elements at each index in the two arrays are equal, false otherwise.

equals

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

Compares the two arrays.

参数：

array1 - the first long array.

array2 - the second long array.

返回：

true if both arrays are null or if the arrays have the same length and the elements at each index in the two arrays are equal, false otherwise.

equals

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

Compares the two arrays. The values are compared in the same manner as Float.equals().

参数：

array1 - the first float array.

array2 - the second float array.

返回：

true if both arrays are null or if the arrays have the same length and the elements at each index in the two arrays are equal, false otherwise.

另请参见：

Float.equals(Object)

equals

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

Compares the two arrays. The values are compared in the same manner as Double.equals().

参数：

array1 - the first double array.

array2 - the second double array.

返回：

true if both arrays are null or if the arrays have the same length and the elements at each index in the two arrays are equal, false otherwise.

另请参见：

Double.equals(Object)

equals

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

Compares the two arrays.

参数：

array1 - the first boolean array.

array2 - the second boolean array.

返回：

true if both arrays are null or if the arrays have the same length and the elements at each index in the two arrays are equal, false otherwise.

equals

public static boolean equals(java.lang.Object[] array1,
                             java.lang.Object[] array2)

Compares the two arrays.

参数：

array1 - the first Object array.

array2 - the second Object array.

返回：

true if both arrays are null or if the arrays have the same length and the elements at each index in the two arrays are equal according to equals(), false otherwise.

deepEquals

public static boolean deepEquals(java.lang.Object[] array1,
                                 java.lang.Object[] array2)

Returns true if the two given arrays are deeply equal to one another. Unlike the method equals(Object[] array1, Object[] array2), this method is appropriate for use for nested arrays of arbitrary depth.

Two array references are considered deeply equal if they are both null, or if they refer to arrays that have the same length and the elements at each index in the two arrays are equal.

Two null elements element1 and element2 are possibly deeply equal if any of the following conditions satisfied:

element1 and element2 are both arrays of object reference types, and Arrays.deepEquals(element1, element2) would return true.

element1 and element2 are arrays of the same primitive type, and the appropriate overloading of Arrays.equals(element1, element2) would return true.

element1 == element2

element1.equals(element2) would return true.

Note that this definition permits null elements at any depth.

If either of the given arrays contain themselves as elements, the behavior of this method is uncertain.

参数：

array1 - the first Object array.

array2 - the second Object array.

返回：

true if both arrays are null or if the arrays have the same length and the elements at each index in the two arrays are equal according to equals(), false otherwise.

toString

public static java.lang.String toString(boolean[] array)

Creates a String representation of the boolean[] passed. The result is surrounded by brackets ("[]"), each element is converted to a String via the String.valueOf(boolean) and separated by ", ". If the array is null, then "null" is returned.

参数：

array - the boolean array to convert.

返回：

the String representation of array.

从以下版本开始：

1.5

toString

public static java.lang.String toString(byte[] array)

Creates a String representation of the byte[] passed. The result is surrounded by brackets ("[]"), each element is converted to a String via the String.valueOf(int) and separated by ", ". If the array is null, then "null" is returned.

参数：

array - the byte array to convert.

返回：

the String representation of array.

从以下版本开始：

1.5

toString

public static java.lang.String toString(char[] array)

Creates a String representation of the char[] passed. The result is surrounded by brackets ("[]"), each element is converted to a String via the String.valueOf(char) and separated by ", ". If the array is null, then "null" is returned.

参数：

array - the char array to convert.

返回：

the String representation of array.

从以下版本开始：

1.5

toString

public static java.lang.String toString(double[] array)

Creates a String representation of the double[] passed. The result is surrounded by brackets ("[]"), each element is converted to a String via the String.valueOf(double) and separated by ", ". If the array is null, then "null" is returned.

参数：

array - the double array to convert.

返回：

the String representation of array.

从以下版本开始：

1.5

toString

public static java.lang.String toString(float[] array)

Creates a String representation of the float[] passed. The result is surrounded by brackets ("[]"), each element is converted to a String via the String.valueOf(float) and separated by ", ". If the array is null, then "null" is returned.

参数：

array - the float array to convert.

返回：

the String representation of array.

从以下版本开始：

1.5

toString

public static java.lang.String toString(int[] array)

Creates a String representation of the int[] passed. The result is surrounded by brackets ("[]"), each element is converted to a String via the String.valueOf(int) and separated by ", ". If the array is null, then "null" is returned.

参数：

array - the int array to convert.

返回：

the String representation of array.

从以下版本开始：

1.5

toString

public static java.lang.String toString(long[] array)

Creates a String representation of the long[] passed. The result is surrounded by brackets ("[]"), each element is converted to a String via the String.valueOf(long) and separated by ", ". If the array is null, then "null" is returned.

参数：

array - the long array to convert.

返回：

the String representation of array.

从以下版本开始：

1.5

toString

public static java.lang.String toString(short[] array)

Creates a String representation of the short[] passed. The result is surrounded by brackets ("[]"), each element is converted to a String via the String.valueOf(int) and separated by ", ". If the array is null, then "null" is returned.

参数：

array - the short array to convert.

返回：

the String representation of array.

从以下版本开始：

1.5

toString

public static java.lang.String toString(java.lang.Object[] array)

Creates a String representation of the Object[] passed. The result is surrounded by brackets ("[]"), each element is converted to a String via the String.valueOf(Object) and separated by ", ". If the array is null, then "null" is returned.

参数：

array - the Object array to convert.

返回：

the String representation of array.

从以下版本开始：

1.5

deepToString

public static java.lang.String deepToString(java.lang.Object[] array)

Creates a "deep" String representation of the Object[] passed, such that if the array contains other arrays, the String representation of those arrays is generated as well.

If any of the elements are primitive arrays, the generation is delegated to the other toString methods in this class. If any element contains a reference to the original array, then it will be represented as "[...]". If an element is an Object[], then its representation is generated by a recursive call to this method. All other elements are converted via the String.valueOf(Object) method.

参数：

array - the Object array to convert.

返回：

the String representation of array.

从以下版本开始：

1.5

copyOf

public static boolean[] copyOf(boolean[] original,
                               int newLength)

Copies newLength elements from original into a new array. If newLength is greater than original.length, the result is padded with the value false.

参数：

original - the original array

newLength - the length of the new array

返回：

the new array

抛出：

java.lang.NegativeArraySizeException - if newLength < 0

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOf

public static byte[] copyOf(byte[] original,
                            int newLength)

Copies newLength elements from original into a new array. If newLength is greater than original.length, the result is padded with the value (byte) 0.

参数：

original - the original array

newLength - the length of the new array

返回：

the new array

抛出：

java.lang.NegativeArraySizeException - if newLength < 0

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOf

public static char[] copyOf(char[] original,
                            int newLength)

Copies newLength elements from original into a new array. If newLength is greater than original.length, the result is padded with the value '\\u0000'.

参数：

original - the original array

newLength - the length of the new array

返回：

the new array

抛出：

java.lang.NegativeArraySizeException - if newLength < 0

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOf

public static double[] copyOf(double[] original,
                              int newLength)

Copies newLength elements from original into a new array. If newLength is greater than original.length, the result is padded with the value 0.0d.

参数：

original - the original array

newLength - the length of the new array

返回：

the new array

抛出：

java.lang.NegativeArraySizeException - if newLength < 0

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOf

public static float[] copyOf(float[] original,
                             int newLength)

Copies newLength elements from original into a new array. If newLength is greater than original.length, the result is padded with the value 0.0f.

参数：

original - the original array

newLength - the length of the new array

返回：

the new array

抛出：

java.lang.NegativeArraySizeException - if newLength < 0

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOf

public static int[] copyOf(int[] original,
                           int newLength)

Copies newLength elements from original into a new array. If newLength is greater than original.length, the result is padded with the value 0.

参数：

original - the original array

newLength - the length of the new array

返回：

the new array

抛出：

java.lang.NegativeArraySizeException - if newLength < 0

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOf

public static long[] copyOf(long[] original,
                            int newLength)

Copies newLength elements from original into a new array. If newLength is greater than original.length, the result is padded with the value 0L.

参数：

original - the original array

newLength - the length of the new array

返回：

the new array

抛出：

java.lang.NegativeArraySizeException - if newLength < 0

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOf

public static short[] copyOf(short[] original,
                             int newLength)

Copies newLength elements from original into a new array. If newLength is greater than original.length, the result is padded with the value (short) 0.

参数：

original - the original array

newLength - the length of the new array

返回：

the new array

抛出：

java.lang.NegativeArraySizeException - if newLength < 0

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOf

public static <T> T[] copyOf(T[] original,
                             int newLength)

Copies newLength elements from original into a new array. If newLength is greater than original.length, the result is padded with the value null.

参数：

original - the original array

newLength - the length of the new array

返回：

the new array

抛出：

java.lang.NegativeArraySizeException - if newLength < 0

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOf

public static <T,U> T[] copyOf(U[] original,
                               int newLength,
                               java.lang.Class<? extends T[]> newType)

Copies newLength elements from original into a new array. If newLength is greater than original.length, the result is padded with the value null.

参数：

original - the original array

newLength - the length of the new array

newType - the class of the new array

返回：

the new array

抛出：

java.lang.NegativeArraySizeException - if newLength < 0

java.lang.NullPointerException - if original == null

java.lang.ArrayStoreException - if a value in original is incompatible with T

从以下版本开始：

1.6

copyOfRange

public static boolean[] copyOfRange(boolean[] original,
                                    int start,
                                    int end)

Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive). The original order of elements is preserved. If end is greater than original.length, the result is padded with the value false.

参数：

original - the original array

start - the start index, inclusive

end - the end index, exclusive

返回：

the new array

抛出：

java.lang.ArrayIndexOutOfBoundsException - if start < 0 || start > original.length

java.lang.IllegalArgumentException - if start > end

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOfRange

public static byte[] copyOfRange(byte[] original,
                                 int start,
                                 int end)

Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive). The original order of elements is preserved. If end is greater than original.length, the result is padded with the value (byte) 0.

参数：

original - the original array

start - the start index, inclusive

end - the end index, exclusive

返回：

the new array

抛出：

java.lang.ArrayIndexOutOfBoundsException - if start < 0 || start > original.length

java.lang.IllegalArgumentException - if start > end

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOfRange

public static char[] copyOfRange(char[] original,
                                 int start,
                                 int end)

Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive). The original order of elements is preserved. If end is greater than original.length, the result is padded with the value '\\u0000'.

参数：

original - the original array

start - the start index, inclusive

end - the end index, exclusive

返回：

the new array

抛出：

java.lang.ArrayIndexOutOfBoundsException - if start < 0 || start > original.length

java.lang.IllegalArgumentException - if start > end

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOfRange

public static double[] copyOfRange(double[] original,
                                   int start,
                                   int end)

Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive). The original order of elements is preserved. If end is greater than original.length, the result is padded with the value 0.0d.

参数：

original - the original array

start - the start index, inclusive

end - the end index, exclusive

返回：

the new array

抛出：

java.lang.ArrayIndexOutOfBoundsException - if start < 0 || start > original.length

java.lang.IllegalArgumentException - if start > end

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOfRange

public static float[] copyOfRange(float[] original,
                                  int start,
                                  int end)

Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive). The original order of elements is preserved. If end is greater than original.length, the result is padded with the value 0.0f.

参数：

original - the original array

start - the start index, inclusive

end - the end index, exclusive

返回：

the new array

抛出：

java.lang.ArrayIndexOutOfBoundsException - if start < 0 || start > original.length

java.lang.IllegalArgumentException - if start > end

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOfRange

public static int[] copyOfRange(int[] original,
                                int start,
                                int end)

Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive). The original order of elements is preserved. If end is greater than original.length, the result is padded with the value 0.

参数：

original - the original array

start - the start index, inclusive

end - the end index, exclusive

返回：

the new array

抛出：

java.lang.ArrayIndexOutOfBoundsException - if start < 0 || start > original.length

java.lang.IllegalArgumentException - if start > end

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOfRange

public static long[] copyOfRange(long[] original,
                                 int start,
                                 int end)

Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive). The original order of elements is preserved. If end is greater than original.length, the result is padded with the value 0L.

参数：

original - the original array

start - the start index, inclusive

end - the end index, exclusive

返回：

the new array

抛出：

java.lang.ArrayIndexOutOfBoundsException - if start < 0 || start > original.length

java.lang.IllegalArgumentException - if start > end

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOfRange

public static short[] copyOfRange(short[] original,
                                  int start,
                                  int end)

Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive). The original order of elements is preserved. If end is greater than original.length, the result is padded with the value (short) 0.

参数：

original - the original array

start - the start index, inclusive

end - the end index, exclusive

返回：

the new array

抛出：

java.lang.ArrayIndexOutOfBoundsException - if start < 0 || start > original.length

java.lang.IllegalArgumentException - if start > end

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOfRange

public static <T> T[] copyOfRange(T[] original,
                                  int start,
                                  int end)

Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive). The original order of elements is preserved. If end is greater than original.length, the result is padded with the value null.

参数：

original - the original array

start - the start index, inclusive

end - the end index, exclusive

返回：

the new array

抛出：

java.lang.ArrayIndexOutOfBoundsException - if start < 0 || start > original.length

java.lang.IllegalArgumentException - if start > end

java.lang.NullPointerException - if original == null

从以下版本开始：

1.6

copyOfRange

public static <T,U> T[] copyOfRange(U[] original,
                                    int start,
                                    int end,
                                    java.lang.Class<? extends T[]> newType)

Copies elements from original into a new array, from indexes start (inclusive) to end (exclusive). The original order of elements is preserved. If end is greater than original.length, the result is padded with the value null.

参数：

original - the original array

start - the start index, inclusive

end - the end index, exclusive

返回：

the new array

抛出：

java.lang.ArrayIndexOutOfBoundsException - if start < 0 || start > original.length

java.lang.IllegalArgumentException - if start > end

java.lang.NullPointerException - if original == null

java.lang.ArrayStoreException - if a value in original is incompatible with T

从以下版本开始：

1.6