Most visited

Recently visited

Added in API level 1

Arrays

public class Arrays
extends Object

java.lang.Object
   ↳ java.util.Arrays


该类包含用于处理数组的各种方法(如排序和搜索)。 该类还包含一个静态工厂,允许将数组视为列表。

如果指定的数组引用为空(除非另有说明),则此类中的方法全部抛出 NullPointerException

这个类中包含的方法的文档包括实现的简要描述。 此类描述应视为实施说明 ,而不是规范的一部分 只要规范本身得到遵守,实现者应该随时替换其他算法。 (例如, sort(Object[])使用的算法不一定是sort(Object[]) ,但它必须是稳定的 。)

本课程是 Java Collections Framework的成员。

Summary

Public methods

static <T> List<T> asList(T... a)

返回由指定数组支持的固定大小列表。

static int binarySearch(char[] a, int fromIndex, int toIndex, char key)

使用二分搜索算法搜索指定字符数组的范围。

static int binarySearch(long[] a, long key)

使用二进制搜索算法搜索指定的long数组。

static int binarySearch(float[] a, int fromIndex, int toIndex, float key)

使用二进制搜索算法搜索指定浮点数组的范围。

static int binarySearch(byte[] a, int fromIndex, int toIndex, byte key)

使用二分搜索算法搜索指定的字节数组的范围。

static int binarySearch(long[] a, int fromIndex, int toIndex, long key)

使用二分搜索算法搜索指定长度的数组的范围。

static int binarySearch(int[] a, int fromIndex, int toIndex, int key)

使用二分搜索算法在指定的整数数组范围内搜索指定的值。

static int binarySearch(short[] a, int fromIndex, int toIndex, short key)

使用二分搜索算法搜索指定数组的短裤的范围。

static <T> int binarySearch(T[] a, int fromIndex, int toIndex, T key, Comparator<? super T> c)

使用二分搜索算法搜索指定数组的范围。

static int binarySearch(byte[] a, byte key)

使用二进制搜索算法在指定的字节数组中搜索指定的值。

static int binarySearch(short[] a, short key)

使用二进制搜索算法搜索指定的短裤阵列以获得指定的值。

static int binarySearch(Object[] a, Object key)

使用二分搜索算法在指定的数组中搜索指定的对象。

static int binarySearch(double[] a, int fromIndex, int toIndex, double key)

使用二分搜索算法,搜索指定数值的双精度数组的范围。

static int binarySearch(Object[] a, int fromIndex, int toIndex, Object key)

使用二分搜索算法搜索指定数组的范围。

static int binarySearch(char[] a, char key)

使用二分搜索算法搜索指定的字符数组以获得指定的值。

static int binarySearch(int[] a, int key)

使用二分搜索算法在指定的整数数组中搜索指定的值。

static int binarySearch(double[] a, double key)

使用二分搜索算法在指定的双精度数组中搜索指定的值。

static <T> int binarySearch(T[] a, T key, Comparator<? super T> c)

使用二分搜索算法在指定的数组中搜索指定的对象。

static int binarySearch(float[] a, float key)

使用二进制搜索算法在指定的浮点数组中搜索指定的值。

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

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。

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

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。

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

复制指定的数组,截断或填充 false (如有必要),以便副本具有指定的长度。

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

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。

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

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。

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

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。

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

复制指定的数组,使用空值截断或填充(如有必要),以便副本具有指定的长度。

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

复制指定的数组,使用空值截断或填充(如有必要),以便副本具有指定的长度。

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

复制指定数组,截断或填充空字符(如有必要),以便副本具有指定的长度。

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

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。

static double[] copyOfRange(double[] original, int from, int to)

将指定数组的指定范围复制到新数组中。

static <T> T[] copyOfRange(T[] original, int from, int to)

将指定数组的指定范围复制到新数组中。

static char[] copyOfRange(char[] original, int from, int to)

将指定数组的指定范围复制到新数组中。

static float[] copyOfRange(float[] original, int from, int to)

将指定数组的指定范围复制到新数组中。

static long[] copyOfRange(long[] original, int from, int to)

将指定数组的指定范围复制到新数组中。

static int[] copyOfRange(int[] original, int from, int to)

将指定数组的指定范围复制到新数组中。

static boolean[] copyOfRange(boolean[] original, int from, int to)

将指定数组的指定范围复制到新数组中。

static <T, U> T[] copyOfRange(U[] original, int from, int to, Class<? extends T[]> newType)

将指定数组的指定范围复制到新数组中。

static short[] copyOfRange(short[] original, int from, int to)

将指定数组的指定范围复制到新数组中。

static byte[] copyOfRange(byte[] original, int from, int to)

将指定数组的指定范围复制到新数组中。

static boolean deepEquals(Object[] a1, Object[] a2)

如果两个指定的数组彼此 深度相等 ,则返回 true

static int deepHashCode(Object[] a)

根据指定数组的“深层内容”返回哈希码。

static String deepToString(Object[] a)

返回指定数组的“深层内容”的字符串表示形式。

static boolean equals(Object[] a, Object[] a2)

如果两个指定的对象数组 相等 ,则返回 true

static boolean equals(double[] a, double[] a2)

如果两个指定的双精度数组 相等 ,则返回 true

static boolean equals(long[] a, long[] a2)

如果两个指定的long数组 相等 ,则返回 true

static boolean equals(char[] a, char[] a2)

如果两个指定的字符数组 相等 ,则返回 true

static boolean equals(boolean[] a, boolean[] a2)

如果两个指定的布尔值数组 相等 ,则返回 true

static boolean equals(int[] a, int[] a2)

如果两个指定的整数数组 相等 ,则返回 true

static boolean equals(float[] a, float[] a2)

如果两个指定的浮点数组 相等 ,则返回 true

static boolean equals(short[] a, short[] a2)

如果两个指定的短裤阵列彼此 相等 ,则返回 true

static boolean equals(byte[] a, byte[] a2)

如果两个指定的字节数组 相等 ,则返回 true

static void fill(float[] a, int fromIndex, int toIndex, float val)

将指定的float值分配给指定float数组指定范围的每个元素。

static void fill(float[] a, float val)

将指定的浮点值分配给指定的浮点数组的每个元素。

static void fill(byte[] a, int fromIndex, int toIndex, byte val)

将指定的字节值分配给指定字节数组的指定范围内的每个元素。

static void fill(char[] a, char val)

将指定的char值分配给指定的字符数组的每个元素。

static void fill(boolean[] a, int fromIndex, int toIndex, boolean val)

将指定的布尔值指定给指定的布尔数组的指定范围的每个元素。

static void fill(char[] a, int fromIndex, int toIndex, char val)

将指定的char值分配给指定的字符数组的指定范围的每个元素。

static void fill(Object[] a, Object val)

将指定的对象引用分配给指定的对象数组的每个元素。

static void fill(double[] a, double val)

将指定的double值指定给指定的双精度数组的每个元素。

static void fill(long[] a, long val)

将指定的long值分配给指定的long数组的每个元素。

static void fill(long[] a, int fromIndex, int toIndex, long val)

将指定的long值分配给指定long数组指定范围的每个元素。

static void fill(byte[] a, byte val)

将指定的字节值分配给指定的字节数组的每个元素。

static void fill(int[] a, int fromIndex, int toIndex, int val)

将指定的int值指定给指定的整数数组的指定范围的每个元素。

static void fill(double[] a, int fromIndex, int toIndex, double val)

将指定的double值分配给指定的双精度数组的指定范围的每个元素。

static void fill(short[] a, int fromIndex, int toIndex, short val)

将指定的short值指定给指定短裤数组的指定范围的每个元素。

static void fill(boolean[] a, boolean val)

将指定的布尔值分配给指定布尔数组的每个元素。

static void fill(short[] a, short val)

将指定的short值分配给指定短裤阵列的每个元素。

static void fill(Object[] a, int fromIndex, int toIndex, Object val)

将指定的对象引用分配给指定的对象数组的指定范围的每个元素。

static void fill(int[] a, int val)

将指定的int值分配给指定的整数数组的每个元素。

static int hashCode(byte[] a)

根据指定数组的内容返回散列码。

static int hashCode(boolean[] a)

根据指定数组的内容返回散列码。

static int hashCode(char[] a)

根据指定数组的内容返回散列码。

static int hashCode(long[] a)

根据指定数组的内容返回散列码。

static int hashCode(int[] a)

根据指定数组的内容返回散列码。

static int hashCode(float[] a)

根据指定数组的内容返回散列码。

static int hashCode(short[] a)

根据指定数组的内容返回散列码。

static int hashCode(Object[] a)

根据指定数组的内容返回散列码。

static int hashCode(double[] a)

根据指定数组的内容返回散列码。

static <T> void parallelPrefix(T[] array, int fromIndex, int toIndex, BinaryOperator<T> op)

对数组的给定子范围执行 parallelPrefix(Object[], BinaryOperator)

static <T> void parallelPrefix(T[] array, BinaryOperator<T> op)

使用提供的函数并行累积给定数组中的每个元素。

static void parallelPrefix(long[] array, LongBinaryOperator op)

使用提供的函数并行累积给定数组中的每个元素。

static void parallelPrefix(long[] array, int fromIndex, int toIndex, LongBinaryOperator op)

针对数组的给定子范围执行 parallelPrefix(long[], LongBinaryOperator)

static void parallelPrefix(int[] array, int fromIndex, int toIndex, IntBinaryOperator op)

对数组的给定子范围执行 parallelPrefix(int[], IntBinaryOperator)

static void parallelPrefix(double[] array, int fromIndex, int toIndex, DoubleBinaryOperator op)

针对数组的给定子范围执行 parallelPrefix(double[], DoubleBinaryOperator)

static void parallelPrefix(double[] array, DoubleBinaryOperator op)

使用提供的函数并行累积给定数组中的每个元素。

static void parallelPrefix(int[] array, IntBinaryOperator op)

使用提供的函数并行累积给定数组中的每个元素。

static void parallelSetAll(double[] array, IntToDoubleFunction generator)

使用提供的生成器函数并行设置指定数组的所有元素来计算每个元素。

static void parallelSetAll(int[] array, IntUnaryOperator generator)

使用提供的生成器函数并行设置指定数组的所有元素来计算每个元素。

static void parallelSetAll(long[] array, IntToLongFunction generator)

使用提供的生成器函数并行设置指定数组的所有元素来计算每个元素。

static <T> void parallelSetAll(T[] array, IntFunction<? extends T> generator)

使用提供的生成器函数并行设置指定数组的所有元素来计算每个元素。

static <T> void parallelSort(T[] a, Comparator<? super T> cmp)

根据指定比较器引发的顺序对指定的对象数组进行排序。

static void parallelSort(long[] a)

按指定的数字顺序将指定的数组排序。

static void parallelSort(short[] a)

按指定的数字顺序将指定的数组排序。

static void parallelSort(double[] a)

按指定的数字顺序将指定的数组排序。

static void parallelSort(char[] a)

按指定的数字顺序将指定的数组排序。

static void parallelSort(double[] a, int fromIndex, int toIndex)

将数组的指定范围按升序编号排序。

static <T extends Comparable<? super T>> void parallelSort(T[] a)

根据元素的 natural ordering将指定的对象数组按照升序排序。

static void parallelSort(float[] a)

按指定的数字顺序将指定的数组排序。

static void parallelSort(byte[] a)

按指定的数字顺序将指定的数组排序。

static void parallelSort(char[] a, int fromIndex, int toIndex)

将数组的指定范围按升序编号排序。

static void parallelSort(int[] a)

按指定的数字顺序将指定的数组排序。

static void parallelSort(long[] a, int fromIndex, int toIndex)

将数组的指定范围按升序编号排序。

static void parallelSort(float[] a, int fromIndex, int toIndex)

将数组的指定范围按升序编号排序。

static void parallelSort(int[] a, int fromIndex, int toIndex)

将数组的指定范围按升序编号排序。

static void parallelSort(byte[] a, int fromIndex, int toIndex)

将数组的指定范围按升序编号排序。

static void parallelSort(short[] a, int fromIndex, int toIndex)

将数组的指定范围按升序编号排序。

static <T extends Comparable<? super T>> void parallelSort(T[] a, int fromIndex, int toIndex)

根据其元素的 natural ordering ,将指定的对象数组的指定范围按升序排序。

static <T> void parallelSort(T[] a, int fromIndex, int toIndex, Comparator<? super T> cmp)

根据指定比较器引发的顺序对指定的对象数组的指定范围进行排序。

static <T> void setAll(T[] array, IntFunction<? extends T> generator)

设置指定数组的所有元素,使用提供的生成器函数来计算每个元素。

static void setAll(double[] array, IntToDoubleFunction generator)

设置指定数组的所有元素,使用提供的生成器函数来计算每个元素。

static void setAll(long[] array, IntToLongFunction generator)

设置指定数组的所有元素,使用提供的生成器函数来计算每个元素。

static void setAll(int[] array, IntUnaryOperator generator)

设置指定数组的所有元素,使用提供的生成器函数来计算每个元素。

static <T> void sort(T[] a, int fromIndex, int toIndex, Comparator<? super T> c)

根据指定比较器引发的顺序对指定的对象数组的指定范围进行排序。

static void sort(int[] a)

按指定的数字顺序将指定的数组排序。

static void sort(long[] a, int fromIndex, int toIndex)

将数组的指定范围按升序排序。

static void sort(double[] a)

按指定的数字顺序将指定的数组排序。

static void sort(short[] a)

按指定的数字顺序将指定的数组排序。

static void sort(char[] a, int fromIndex, int toIndex)

将数组的指定范围按升序排序。

static void sort(long[] a)

按指定的数字顺序将指定的数组排序。

static void sort(float[] a, int fromIndex, int toIndex)

将数组的指定范围按升序排序。

static void sort(short[] a, int fromIndex, int toIndex)

将数组的指定范围按升序排序。

static <T> void sort(T[] a, Comparator<? super T> c)

根据指定比较器引发的顺序对指定的对象数组进行排序。

static void sort(byte[] a)

按指定的数字顺序将指定的数组排序。

static void sort(Object[] a, int fromIndex, int toIndex)

根据其元素的 natural ordering ,将指定的对象数组的指定范围按升序排序。

static void sort(char[] a)

按指定的数字顺序将指定的数组排序。

static void sort(double[] a, int fromIndex, int toIndex)

将数组的指定范围按升序排序。

static void sort(Object[] a)

根据元素的 natural ordering将指定的对象数组按照升序排序。

static void sort(int[] a, int fromIndex, int toIndex)

将数组的指定范围按升序排序。

static void sort(byte[] a, int fromIndex, int toIndex)

将数组的指定范围按升序排序。

static void sort(float[] a)

按指定的数字顺序将指定的数组排序。

static Spliterator.OfLong spliterator(long[] array, int startInclusive, int endExclusive)

返回覆盖指定数组的指定范围的 Spliterator.OfLong

static Spliterator.OfLong spliterator(long[] array)

返回涵盖所有指定数组的 Spliterator.OfLong

static Spliterator.OfDouble spliterator(double[] array)

返回覆盖整个指定数组的 Spliterator.OfDouble

static Spliterator.OfInt spliterator(int[] array, int startInclusive, int endExclusive)

返回覆盖指定数组的指定范围的 Spliterator.OfInt

static <T> Spliterator<T> spliterator(T[] array)

返回涵盖所有指定数组的 Spliterator

static Spliterator.OfInt spliterator(int[] array)

返回涵盖所有指定数组的 Spliterator.OfInt

static <T> Spliterator<T> spliterator(T[] array, int startInclusive, int endExclusive)

返回覆盖指定数组的指定范围的 Spliterator

static Spliterator.OfDouble spliterator(double[] array, int startInclusive, int endExclusive)

返回覆盖指定数组的指定范围的 Spliterator.OfDouble

static IntStream stream(int[] array)

返回指定数组作为其源的顺序 IntStream

static LongStream stream(long[] array)

返回指定数组作为其源的顺序 LongStream

static <T> Stream<T> stream(T[] array)

返回指定数组作为其源的顺序 Stream

static DoubleStream stream(double[] array, int startInclusive, int endExclusive)

返回指定数组的指定范围作为其源的顺序 DoubleStream

static DoubleStream stream(double[] array)

返回指定数组作为其源的顺序 DoubleStream

static IntStream stream(int[] array, int startInclusive, int endExclusive)

返回指定数组的指定范围作为其源的顺序 IntStream

static <T> Stream<T> stream(T[] array, int startInclusive, int endExclusive)

返回指定数组的指定范围作为其源的顺序 Stream

static LongStream stream(long[] array, int startInclusive, int endExclusive)

返回指定数组的指定范围作为其源的顺序 LongStream

static String toString(float[] a)

返回指定数组内容的字符串表示形式。

static String toString(int[] a)

返回指定数组内容的字符串表示形式。

static String toString(Object[] a)

返回指定数组内容的字符串表示形式。

static String toString(long[] a)

返回指定数组内容的字符串表示形式。

static String toString(boolean[] a)

返回指定数组内容的字符串表示形式。

static String toString(double[] a)

返回指定数组内容的字符串表示形式。

static String toString(short[] a)

返回指定数组内容的字符串表示形式。

static String toString(char[] a)

返回指定数组内容的字符串表示形式。

static String toString(byte[] a)

返回指定数组内容的字符串表示形式。

Inherited methods

From class java.lang.Object

Public methods

asList

Added in API level 1
List<T> asList (T... a)

返回由指定数组支持的固定大小列表。 (对返回列表进行“写通”到数组的更改。)此方法充当基于数组和基于集合的API之间的桥梁,并结合使用toArray() 返回的列表是可序列化的并实现RandomAccess

此方法还提供了一种便捷方式来创建初始化为包含多个元素的固定大小列表:

     List<String> stooges = Arrays.asList("Larry", "Moe", "Curly");
 

Parameters
a T: the array by which the list will be backed
Returns
List<T> a list view of the specified array

binarySearch

Added in API level 9
int binarySearch (char[] a, 
                int fromIndex, 
                int toIndex, 
                char key)

使用二分搜索算法搜索指定字符数组的范围。 在进行此呼叫之前,必须对范围进行排序(如通过sort(char[], int, int)方法)。 如果没有排序,结果是不确定的。 如果范围包含具有指定值的多个元素,则不能保证会找到哪个元素。

Parameters
a char: the array to be searched
fromIndex int: the index of the first element (inclusive) to be searched
toIndex int: the index of the last element (exclusive) to be searched
key char: the value to be searched for
Returns
int index of the search key, if it is contained in the array within the specified range; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element in the range greater than the key, or toIndex if all elements in the range are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

binarySearch

Added in API level 1
int binarySearch (long[] a, 
                long key)

使用二进制搜索算法搜索指定的long数组。 在发出此呼叫之前,必须对数组进行排序(如通过sort(long[])方法)。 如果没有排序,结果是不确定的。 如果数组包含具有指定值的多个元素,则不能保证会找到哪个元素。

Parameters
a long: the array to be searched
key long: the value to be searched for
Returns
int index of the search key, if it is contained in the array; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element greater than the key, or a.length if all elements in the array are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.

binarySearch

Added in API level 9
int binarySearch (float[] a, 
                int fromIndex, 
                int toIndex, 
                float key)

使用二进制搜索算法搜索指定浮点数组的范围。 在进行此呼叫之前,必须对范围进行排序(如通过sort(float[], int, int)方法)。 如果没有排序,结果是不确定的。 如果范围包含具有指定值的多个元素,则不能保证会找到哪个元素。 这种方法认为所有的NaN值是相等和相等的。

Parameters
a float: the array to be searched
fromIndex int: the index of the first element (inclusive) to be searched
toIndex int: the index of the last element (exclusive) to be searched
key float: the value to be searched for
Returns
int index of the search key, if it is contained in the array within the specified range; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element in the range greater than the key, or toIndex if all elements in the range are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

binarySearch

Added in API level 9
int binarySearch (byte[] a, 
                int fromIndex, 
                int toIndex, 
                byte key)

使用二分搜索算法搜索指定的字节数组的范围。 在进行此呼叫之前,必须对范围进行排序(如通过sort(byte[], int, int)方法)。 如果没有排序,结果是不确定的。 如果范围包含具有指定值的多个元素,则不能保证会找到哪个元素。

Parameters
a byte: the array to be searched
fromIndex int: the index of the first element (inclusive) to be searched
toIndex int: the index of the last element (exclusive) to be searched
key byte: the value to be searched for
Returns
int index of the search key, if it is contained in the array within the specified range; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element in the range greater than the key, or toIndex if all elements in the range are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

binarySearch

Added in API level 9
int binarySearch (long[] a, 
                int fromIndex, 
                int toIndex, 
                long key)

使用二分搜索算法搜索指定长度的数组的范围。 在进行此呼叫之前,必须对范围进行排序(如通过sort(long[], int, int)方法)。 如果没有排序,结果是不确定的。 如果范围包含具有指定值的多个元素,则不能保证会找到哪个元素。

Parameters
a long: the array to be searched
fromIndex int: the index of the first element (inclusive) to be searched
toIndex int: the index of the last element (exclusive) to be searched
key long: the value to be searched for
Returns
int index of the search key, if it is contained in the array within the specified range; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element in the range greater than the key, or toIndex if all elements in the range are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

binarySearch

Added in API level 9
int binarySearch (int[] a, 
                int fromIndex, 
                int toIndex, 
                int key)

使用二分搜索算法在指定的整数数组范围内搜索指定的值。 在进行此呼叫之前,必须对范围进行排序(如通过sort(int[], int, int)方法)。 如果没有排序,结果是不确定的。 如果范围包含具有指定值的多个元素,则不能保证会找到哪个元素。

Parameters
a int: the array to be searched
fromIndex int: the index of the first element (inclusive) to be searched
toIndex int: the index of the last element (exclusive) to be searched
key int: the value to be searched for
Returns
int index of the search key, if it is contained in the array within the specified range; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element in the range greater than the key, or toIndex if all elements in the range are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

binarySearch

Added in API level 9
int binarySearch (short[] a, 
                int fromIndex, 
                int toIndex, 
                short key)

使用二分搜索算法搜索指定数组的短裤的范围。 在进行此呼叫之前,必须对范围进行排序(如通过sort(short[], int, int)方法)。 如果没有排序,结果是不确定的。 如果范围包含具有指定值的多个元素,则不能保证会找到哪个元素。

Parameters
a short: the array to be searched
fromIndex int: the index of the first element (inclusive) to be searched
toIndex int: the index of the last element (exclusive) to be searched
key short: the value to be searched for
Returns
int index of the search key, if it is contained in the array within the specified range; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element in the range greater than the key, or toIndex if all elements in the range are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

binarySearch

Added in API level 9
int binarySearch (T[] a, 
                int fromIndex, 
                int toIndex, 
                T key, 
                Comparator<? super T> c)

使用二分搜索算法搜索指定数组的范围。 在进行此呼叫之前,范围必须根据指定的比较器按升序排序(如sort(T[], int, int, Comparator)方法)。 如果没有排序,结果是不确定的。 如果范围包含与指定对象相同的多个元素,则不能保证会找到哪一个元素。

Parameters
a T: the array to be searched
fromIndex int: the index of the first element (inclusive) to be searched
toIndex int: the index of the last element (exclusive) to be searched
key T: the value to be searched for
c Comparator: the comparator by which the array is ordered. A null value indicates that the elements' natural ordering should be used.
Returns
int index of the search key, if it is contained in the array within the specified range; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element in the range greater than the key, or toIndex if all elements in the range are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
ClassCastException if the range contains elements that are not mutually comparable using the specified comparator, or the search key is not comparable to the elements in the range using this comparator.
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

binarySearch

Added in API level 1
int binarySearch (byte[] a, 
                byte key)

使用二进制搜索算法在指定的字节数组中搜索指定的值。 在进行此调用之前,必须对数组进行排序(如由sort(byte[])方法)。 如果没有排序,结果是不确定的。 如果数组包含具有指定值的多个元素,则不能保证会找到哪个元素。

Parameters
a byte: the array to be searched
key byte: the value to be searched for
Returns
int index of the search key, if it is contained in the array; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element greater than the key, or a.length if all elements in the array are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.

binarySearch

Added in API level 1
int binarySearch (short[] a, 
                short key)

使用二进制搜索算法搜索指定的短裤阵列以获得指定的值。 在进行此调用之前,必须对数组进行排序(如通过sort(short[])方法)。 如果没有排序,结果是不确定的。 如果数组包含具有指定值的多个元素,则不能保证会找到哪个元素。

Parameters
a short: the array to be searched
key short: the value to be searched for
Returns
int index of the search key, if it is contained in the array; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element greater than the key, or a.length if all elements in the array are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.

binarySearch

Added in API level 1
int binarySearch (Object[] a, 
                Object key)

使用二分搜索算法在指定的数组中搜索指定的对象。 在进行此调用之前,必须按照元素的natural ordering升序排列数组(如sort(Object[])方法)。 如果没有排序,结果是不确定的。 (如果数组包含不可相互比较的元素(例如,字符串和整数),则不能根据元素的自然顺序进行排序,因此结果未定义。)如果数组包含与指定对象相同的多个元素,不能保证哪一个会被发现。

Parameters
a Object: the array to be searched
key Object: the value to be searched for
Returns
int index of the search key, if it is contained in the array; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element greater than the key, or a.length if all elements in the array are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
ClassCastException if the search key is not comparable to the elements of the array.

binarySearch

Added in API level 9
int binarySearch (double[] a, 
                int fromIndex, 
                int toIndex, 
                double key)

使用二分搜索算法,搜索指定数值的双精度数组的范围。 在进行此呼叫之前,必须对范围进行排序(如通过sort(double[], int, int)方法)。 如果没有排序,结果是不确定的。 如果范围包含具有指定值的多个元素,则不能保证会找到哪个元素。 这种方法认为所有的NaN值是相等和相等的。

Parameters
a double: the array to be searched
fromIndex int: the index of the first element (inclusive) to be searched
toIndex int: the index of the last element (exclusive) to be searched
key double: the value to be searched for
Returns
int index of the search key, if it is contained in the array within the specified range; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element in the range greater than the key, or toIndex if all elements in the range are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

binarySearch

Added in API level 9
int binarySearch (Object[] a, 
                int fromIndex, 
                int toIndex, 
                Object key)

使用二分搜索算法搜索指定数组的范围。 的范围必须根据被按升序排列natural ordering元素(如由sort(Object[], int, int)方法)之前使该呼叫。 如果没有排序,结果是不确定的。 (如果范围包含不可相互比较的元素(例如,字符串和整数),则不能根据其元素的自然顺序进行排序,因此结果是未定义的。)如果范围包含多个元素等于指定对象,不能保证哪一个会被发现。

Parameters
a Object: the array to be searched
fromIndex int: the index of the first element (inclusive) to be searched
toIndex int: the index of the last element (exclusive) to be searched
key Object: the value to be searched for
Returns
int index of the search key, if it is contained in the array within the specified range; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element in the range greater than the key, or toIndex if all elements in the range are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
ClassCastException if the search key is not comparable to the elements of the array within the specified range.
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

binarySearch

Added in API level 1
int binarySearch (char[] a, 
                char key)

使用二分搜索算法搜索指定的字符数组以获得指定的值。 在进行此调用之前,必须对数组进行排序(如sort(char[])方法)。 如果没有排序,结果是不确定的。 如果数组包含具有指定值的多个元素,则不能保证会找到哪个元素。

Parameters
a char: the array to be searched
key char: the value to be searched for
Returns
int index of the search key, if it is contained in the array; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element greater than the key, or a.length if all elements in the array are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.

binarySearch

Added in API level 1
int binarySearch (int[] a, 
                int key)

使用二分搜索算法在指定的整数数组中搜索指定的值。 在进行此调用之前,必须对数组进行排序(如通过sort(int[])方法)。 如果没有排序,结果是不确定的。 如果数组包含具有指定值的多个元素,则不能保证会找到哪个元素。

Parameters
a int: the array to be searched
key int: the value to be searched for
Returns
int index of the search key, if it is contained in the array; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element greater than the key, or a.length if all elements in the array are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.

binarySearch

Added in API level 1
int binarySearch (double[] a, 
                double key)

使用二分搜索算法在指定的双精度数组中搜索指定的值。 在进行此调用之前,必须对数组进行排序(如通过sort(double[])方法)。 如果没有排序,结果是不确定的。 如果数组包含具有指定值的多个元素,则不能保证会找到哪个元素。 这种方法认为所有的NaN值是相等和相等的。

Parameters
a double: the array to be searched
key double: the value to be searched for
Returns
int index of the search key, if it is contained in the array; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element greater than the key, or a.length if all elements in the array are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.

binarySearch

Added in API level 1
int binarySearch (T[] a, 
                T key, 
                Comparator<? super T> c)

使用二分搜索算法在指定的数组中搜索指定的对象。 在进行此调用之前,必须根据指定的比较器按照升序排列数组(如sort(T[], Comparator)方法)。 如果没有排序,结果是不确定的。 如果数组包含与指定对象相同的多个元素,则不能保证会找到哪一个元素。

Parameters
a T: the array to be searched
key T: the value to be searched for
c Comparator: the comparator by which the array is ordered. A null value indicates that the elements' natural ordering should be used.
Returns
int index of the search key, if it is contained in the array; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element greater than the key, or a.length if all elements in the array are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.
Throws
ClassCastException if the array contains elements that are not mutually comparable using the specified comparator, or the search key is not comparable to the elements of the array using this comparator.

binarySearch

Added in API level 1
int binarySearch (float[] a, 
                float key)

使用二进制搜索算法在指定的浮点数组中搜索指定的值。 在进行此调用之前,必须对数组进行排序(如通过sort(float[])方法)。 如果没有排序,结果是不确定的。 如果数组包含具有指定值的多个元素,则不能保证会找到哪个元素。 这种方法认为所有的NaN值是相等和相等的。

Parameters
a float: the array to be searched
key float: the value to be searched for
Returns
int index of the search key, if it is contained in the array; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element greater than the key, or a.length if all elements in the array are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.

copyOf

Added in API level 9
double[] copyOf (double[] original, 
                int newLength)

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。 对于在原始数组和复制中都有效的所有索引,这两个数组将包含相同的值。 对于在副本中有效但不是原件的任何索引,副本将包含0d 当且仅当指定的长度大于原始数组的长度时,这些指数才会存在。

Parameters
original double: the array to be copied
newLength int: the length of the copy to be returned
Returns
double[] a copy of the original array, truncated or padded with zeros to obtain the specified length
Throws
NegativeArraySizeException if newLength is negative
NullPointerException if original is null

copyOf

Added in API level 9
float[] copyOf (float[] original, 
                int newLength)

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。 对于在原始数组和复制中都有效的所有索引,这两个数组将包含相同的值。 对于在副本中有效但不是原件的任何索引,副本将包含0f 当且仅当指定的长度大于原始数组的长度时,这些指数才会存在。

Parameters
original float: the array to be copied
newLength int: the length of the copy to be returned
Returns
float[] a copy of the original array, truncated or padded with zeros to obtain the specified length
Throws
NegativeArraySizeException if newLength is negative
NullPointerException if original is null

copyOf

Added in API level 9
boolean[] copyOf (boolean[] original, 
                int newLength)

复制指定数组,截断或填充false (如有必要),以便副本具有指定的长度。 对于在原始数组和复制中都有效的所有索引,这两个数组将包含相同的值。 对于在副本中有效但不是原件的任何索引,副本将包含false 当且仅当指定的长度大于原始数组的长度时,这些指数才会存在。

Parameters
original boolean: the array to be copied
newLength int: the length of the copy to be returned
Returns
boolean[] a copy of the original array, truncated or padded with false elements to obtain the specified length
Throws
NegativeArraySizeException if newLength is negative
NullPointerException if original is null

copyOf

Added in API level 9
int[] copyOf (int[] original, 
                int newLength)

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。 对于在原始数组和复制中都有效的所有索引,这两个数组将包含相同的值。 对于在复印件中有效但不是原件的任何索引,副本将包含0 当且仅当指定的长度大于原始数组的长度时,这些指数才会存在。

Parameters
original int: the array to be copied
newLength int: the length of the copy to be returned
Returns
int[] a copy of the original array, truncated or padded with zeros to obtain the specified length
Throws
NegativeArraySizeException if newLength is negative
NullPointerException if original is null

copyOf

Added in API level 9
long[] copyOf (long[] original, 
                int newLength)

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。 对于在原始数组和复制中都有效的所有索引,这两个数组将包含相同的值。 对于在副本中有效但不是原件的任何索引,副本将包含0L 当且仅当指定的长度大于原始数组的长度时,这些指数才会存在。

Parameters
original long: the array to be copied
newLength int: the length of the copy to be returned
Returns
long[] a copy of the original array, truncated or padded with zeros to obtain the specified length
Throws
NegativeArraySizeException if newLength is negative
NullPointerException if original is null

copyOf

Added in API level 9
short[] copyOf (short[] original, 
                int newLength)

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。 对于在原始数组和复制中都有效的所有索引,这两个数组将包含相同的值。 对于在副本中有效但不是原件的任何索引,副本将包含(short)0 当且仅当指定的长度大于原始数组的长度时,这些指数才会存在。

Parameters
original short: the array to be copied
newLength int: the length of the copy to be returned
Returns
short[] a copy of the original array, truncated or padded with zeros to obtain the specified length
Throws
NegativeArraySizeException if newLength is negative
NullPointerException if original is null

copyOf

Added in API level 9
T[] copyOf (U[] original, 
                int newLength, 
                Class<? extends T[]> newType)

复制指定的数组,使用空值截断或填充(如有必要),以便副本具有指定的长度。 对于在原始数组和复制中都有效的所有索引,这两个数组将包含相同的值。 对于在副本中有效但不是原件的任何索引,副本将包含null 当且仅当指定的长度大于原始数组的长度时,这些指数才会存在。 得到的数组是类newType

Parameters
original U: the array to be copied
newLength int: the length of the copy to be returned
newType Class: the class of the copy to be returned
Returns
T[] a copy of the original array, truncated or padded with nulls to obtain the specified length
Throws
NegativeArraySizeException if newLength is negative
NullPointerException if original is null
ArrayStoreException if an element copied from original is not of a runtime type that can be stored in an array of class newType

copyOf

Added in API level 9
T[] copyOf (T[] original, 
                int newLength)

复制指定的数组,使用空值截断或填充(如有必要),以便副本具有指定的长度。 对于在原始数组和复制中都有效的所有索引,这两个数组将包含相同的值。 对于在副本中有效但不是原件的任何索引,副本将包含null 当且仅当指定的长度大于原始数组的长度时,这些指数才会存在。 结果数组与原始数组的类完全相同。

Parameters
original T: the array to be copied
newLength int: the length of the copy to be returned
Returns
T[] a copy of the original array, truncated or padded with nulls to obtain the specified length
Throws
NegativeArraySizeException if newLength is negative
NullPointerException if original is null

copyOf

Added in API level 9
char[] copyOf (char[] original, 
                int newLength)

复制指定数组,截断或填充空字符(如有必要),以便副本具有指定的长度。 对于在原始数组和复制中都有效的所有索引,这两个数组将包含相同的值。 对于在副本中有效但不是原始副本的索引,副本将包含'\\u000' 当且仅当指定的长度大于原始数组的长度时,这些指数才会存在。

Parameters
original char: the array to be copied
newLength int: the length of the copy to be returned
Returns
char[] a copy of the original array, truncated or padded with null characters to obtain the specified length
Throws
NegativeArraySizeException if newLength is negative
NullPointerException if original is null

copyOf

Added in API level 9
byte[] copyOf (byte[] original, 
                int newLength)

复制指定的数组,截断或用零填充(如有必要),以便副本具有指定的长度。 对于在原始数组和复制中都有效的所有索引,这两个数组将包含相同的值。 对于在副本中有效但不是原件的任何索引,副本将包含(byte)0 当且仅当指定的长度大于原始数组的长度时,这些指数才会存在。

Parameters
original byte: the array to be copied
newLength int: the length of the copy to be returned
Returns
byte[] a copy of the original array, truncated or padded with zeros to obtain the specified length
Throws
NegativeArraySizeException if newLength is negative
NullPointerException if original is null

copyOfRange

Added in API level 9
double[] copyOfRange (double[] original, 
                int from, 
                int to)

将指定数组的指定范围复制到新数组中。 范围的初始索引( from )必须介于零和original.length之间,包括在内。 original[from]处的值放入副本的初始元素中(除非from == original.lengthfrom == to )。 原始数组中后续元素的值将放入副本中的后续元素中。 范围的最终索引( to )必须大于或等于from ,可能大于original.length ,在这种情况下, 0d将放置在索引大于或等于original.length - from的副本的所有元素中。 返回数组的长度将为to - from

Parameters
original double: the array from which a range is to be copied
from int: the initial index of the range to be copied, inclusive
to int: the final index of the range to be copied, exclusive. (This index may lie outside the array.)
Returns
double[] a new array containing the specified range from the original array, truncated or padded with zeros to obtain the required length
Throws
ArrayIndexOutOfBoundsException if from < 0 or from > original.length
IllegalArgumentException if from > to
NullPointerException if original is null

copyOfRange

Added in API level 9
T[] copyOfRange (T[] original, 
                int from, 
                int to)

将指定数组的指定范围复制到新数组中。 范围的初始索引( from )必须介于0和original.length之间,包括0和original.length original[from]处的值被放置到副本的初始元素中(除非from == original.lengthfrom == to )。 原始数组中后续元素的值将放入副本中的后续元素中。 范围的最终索引( to )必须大于或等于from ,可能大于original.length ,在这种情况下, null将放置在索引大于或等于original.length - from的副本的所有元素中。 返回数组的长度将为to - from

结果数组与原始数组的类完全相同。

Parameters
original T: the array from which a range is to be copied
from int: the initial index of the range to be copied, inclusive
to int: the final index of the range to be copied, exclusive. (This index may lie outside the array.)
Returns
T[] a new array containing the specified range from the original array, truncated or padded with nulls to obtain the required length
Throws
ArrayIndexOutOfBoundsException if from < 0 or from > original.length
IllegalArgumentException if from > to
NullPointerException if original is null

copyOfRange

Added in API level 9
char[] copyOfRange (char[] original, 
                int from, 
                int to)

将指定数组的指定范围复制到新数组中。 范围的初始索引( from )必须位于零和original.length之间,包括在内。 original[from]处的值放入副本的初始元素中(除非from == original.lengthfrom == to )。 原始数组中后续元素的值将放入副本中的后续元素中。 范围的最终索引( to )必须大于或等于from ,可能大于original.length ,在这种情况下, '\\u000'将放置在索引大于或等于original.length - from的副本的所有元素中。 返回数组的长度将为to - from

Parameters
original char: the array from which a range is to be copied
from int: the initial index of the range to be copied, inclusive
to int: the final index of the range to be copied, exclusive. (This index may lie outside the array.)
Returns
char[] a new array containing the specified range from the original array, truncated or padded with null characters to obtain the required length
Throws
ArrayIndexOutOfBoundsException if from < 0 or from > original.length
IllegalArgumentException if from > to
NullPointerException if original is null

copyOfRange

Added in API level 9
float[] copyOfRange (float[] original, 
                int from, 
                int to)

将指定数组的指定范围复制到新数组中。 范围的初始索引( from )必须介于0和original.length之间,包括0和original.length original[from]处的值放入副本的初始元素中(除非from == original.lengthfrom == to )。 原始数组中后续元素的值将放入副本中的后续元素中。 范围的最终索引( to )必须大于或等于from ,可能大于original.length ,在这种情况下, 0f将放置在索引大于或等于original.length - from的副本的所有元素中。 返回数组的长度将为to - from

Parameters
original float: the array from which a range is to be copied
from int: the initial index of the range to be copied, inclusive
to int: the final index of the range to be copied, exclusive. (This index may lie outside the array.)
Returns
float[] a new array containing the specified range from the original array, truncated or padded with zeros to obtain the required length
Throws
ArrayIndexOutOfBoundsException if from < 0 or from > original.length
IllegalArgumentException if from > to
NullPointerException if original is null

copyOfRange

Added in API level 9
long[] copyOfRange (long[] original, 
                int from, 
                int to)

将指定数组的指定范围复制到新数组中。 范围的初始索引( from )必须介于零和original.length之间,包括在内。 original[from]处的值放入副本的初始元素(除非from == original.lengthfrom == to )。 原始数组中后续元素的值将放入副本中的后续元素中。 范围的最终索引( to )必须大于或等于from ,可能大于original.length ,在这种情况下, 0L将放置在索引大于或等于original.length - from的副本的所有元素中。 返回的数组的长度将是to - from

Parameters
original long: the array from which a range is to be copied
from int: the initial index of the range to be copied, inclusive
to int: the final index of the range to be copied, exclusive. (This index may lie outside the array.)
Returns
long[] a new array containing the specified range from the original array, truncated or padded with zeros to obtain the required length
Throws
ArrayIndexOutOfBoundsException if from < 0 or from > original.length
IllegalArgumentException if from > to
NullPointerException if original is null

copyOfRange

Added in API level 9
int[] copyOfRange (int[] original, 
                int from, 
                int to)

将指定数组的指定范围复制到新数组中。 范围的初始索引( from )必须介于零和original.length之间,包括在内。 original[from]处的值放入副本的初始元素中(除非from == original.lengthfrom == to )。 原始数组中后续元素的值将放入副本中的后续元素中。 范围的最终索引( to )必须大于或等于from ,可能大于original.length ,在这种情况下, 0将放置在索引大于或等于original.length - from的副本的所有元素中。 返回数组的长度将为to - from

Parameters
original int: the array from which a range is to be copied
from int: the initial index of the range to be copied, inclusive
to int: the final index of the range to be copied, exclusive. (This index may lie outside the array.)
Returns
int[] a new array containing the specified range from the original array, truncated or padded with zeros to obtain the required length
Throws
ArrayIndexOutOfBoundsException if from < 0 or from > original.length
IllegalArgumentException if from > to
NullPointerException if original is null

copyOfRange

Added in API level 9
boolean[] copyOfRange (boolean[] original, 
                int from, 
                int to)

将指定数组的指定范围复制到新数组中。 范围的初始索引( from )必须介于零和original.length之间,包括在内。 original[from]处的值被放置到副本的初始元素中(除非from == original.lengthfrom == to )。 原始数组中后续元素的值将放入副本中的后续元素中。 范围的最终索引( to )必须大于或等于from ,可能大于original.length ,在这种情况下, false将放置在索引大于或等于original.length - from的副本的所有元素中。 返回数组的长度将为to - from

Parameters
original boolean: the array from which a range is to be copied
from int: the initial index of the range to be copied, inclusive
to int: the final index of the range to be copied, exclusive. (This index may lie outside the array.)
Returns
boolean[] a new array containing the specified range from the original array, truncated or padded with false elements to obtain the required length
Throws
ArrayIndexOutOfBoundsException if from < 0 or from > original.length
IllegalArgumentException if from > to
NullPointerException if original is null

copyOfRange

Added in API level 9
T[] copyOfRange (U[] original, 
                int from, 
                int to, 
                Class<? extends T[]> newType)

将指定数组的指定范围复制到新数组中。 范围的初始索引( from )必须介于零和original.length之间(包括)。 original[from]处的值放入副本的初始元素中(除非from == original.lengthfrom == to )。 原始数组中后续元素的值将放入副本中的后续元素中。 范围的最终索引( to )必须大于或等于from ,可能大于original.length ,在这种情况下, null将放置在索引大于或等于original.length - from的副本的所有元素中。 返回数组的长度将为to - from 结果数组是类newType

Parameters
original U: the array from which a range is to be copied
from int: the initial index of the range to be copied, inclusive
to int: the final index of the range to be copied, exclusive. (This index may lie outside the array.)
newType Class: the class of the copy to be returned
Returns
T[] a new array containing the specified range from the original array, truncated or padded with nulls to obtain the required length
Throws
ArrayIndexOutOfBoundsException if from < 0 or from > original.length
IllegalArgumentException if from > to
NullPointerException if original is null
ArrayStoreException if an element copied from original is not of a runtime type that can be stored in an array of class newType.

copyOfRange

Added in API level 9
short[] copyOfRange (short[] original, 
                int from, 
                int to)

将指定数组的指定范围复制到新数组中。 范围的初始索引( from )必须介于零和original.length之间,包括在内。 original[from]处的值放入副本的初始元素中(除非from == original.lengthfrom == to )。 原始数组中后续元素的值将放入副本中的后续元素中。 范围的最终索引( to )(必须大于或等于from )可能大于original.length ,在这种情况下, (short)0放置在索引大于或等于original.length - from的副本的所有元素中。 返回数组的长度将为to - from

Parameters
original short: the array from which a range is to be copied
from int: the initial index of the range to be copied, inclusive
to int: the final index of the range to be copied, exclusive. (This index may lie outside the array.)
Returns
short[] a new array containing the specified range from the original array, truncated or padded with zeros to obtain the required length
Throws
ArrayIndexOutOfBoundsException if from < 0 or from > original.length
IllegalArgumentException if from > to
NullPointerException if original is null

copyOfRange

Added in API level 9
byte[] copyOfRange (byte[] original, 
                int from, 
                int to)

将指定数组的指定范围复制到新数组中。 范围的初始索引( from )必须介于零和original.length之间,包括在内。 original[from]处的值放入副本的初始元素中(除非from == original.lengthfrom == to )。 原始数组中后续元素的值将放入副本中的后续元素中。 范围的最终索引( to )必须大于或等于from ,可能大于original.length ,在这种情况下, (byte)0将放置在索引大于或等于original.length - from的副本的所有元素中。 返回数组的长度将为to - from

Parameters
original byte: the array from which a range is to be copied
from int: the initial index of the range to be copied, inclusive
to int: the final index of the range to be copied, exclusive. (This index may lie outside the array.)
Returns
byte[] a new array containing the specified range from the original array, truncated or padded with zeros to obtain the required length
Throws
ArrayIndexOutOfBoundsException if from < 0 or from > original.length
IllegalArgumentException if from > to
NullPointerException if original is null

deepEquals

Added in API level 1
boolean deepEquals (Object[] a1, 
                Object[] a2)

如果两个指定的数组彼此深度相等 ,则返回true equals(Object[], Object[])方法不同,此方法适用于任意深度的嵌套数组。

如果二者都是 null ,或者如果它们引用包含相同数量的元素的数组,并且两个数组中的所有相应元素对都非常相等,则两个数组引用被认为是相等的。

如果满足以下任何条件,则两个可能的 null元素 e1e2是深深相等的:

  • e1 and e2 are both arrays of object reference types, and Arrays.deepEquals(e1, e2) would return true
  • e1 and e2 are arrays of the same primitive type, and the appropriate overloading of Arrays.equals(e1, e2) would return true.
  • e1 == e2
  • e1.equals(e2) would return true.
Note that this definition permits null elements at any depth.

如果指定数组中的任何一个直接或间接通过一个或多个数组级别将它们自己包含为元素,则此方法的行为是未定义的。

Parameters
a1 Object: one array to be tested for equality
a2 Object: the other array to be tested for equality
Returns
boolean true if the two arrays are equal

也可以看看:

deepHashCode

Added in API level 1
int deepHashCode (Object[] a)

根据指定数组的“深层内容”返回哈希码。 如果数组包含其他数组作为元素,则散列码基于其内容等,并且无限。 因此,在包含自身作为元素的数组上调用此方法是不可接受的,无论是直接还是间接通过一个或多个数组级别。 这种调用的行为是未定义的。

对于任何两个阵列 ab这样的 Arrays.deepEquals(a, b) ,情况也是如此 Arrays.deepHashCode(a) == Arrays.deepHashCode(b)

通过此方法返回的值的计算是类似于由返回的值的hashCode()包含相同的元素作为a以相同的顺序在列表上,有一点不同:如果一个元素的a e本身是一个阵列,其散列代码不是通过调用e.hashCode()来计算的,而是通过调用适当的Arrays.hashCode(e)的重载,如果e是一个基本类型的数组,或者如果e是一个引用类型的数组,则递归调用Arrays.deepHashCode(e) 如果anull ,则此方法返回0。

Parameters
a Object: the array whose deep-content-based hash code to compute
Returns
int a deep-content-based hash code for a

也可以看看:

deepToString

Added in API level 1
String deepToString (Object[] a)

返回指定数组的“深层内容”的字符串表示形式。 如果该数组包含其他数组作为元素,则该字符串表示形式将包含其内容等等。 此方法旨在将多维数组转换为字符串。

字符串表示由数组元素的列表组成,方括号( "[]" )。 相邻元素由字符", " (逗号后跟一个空格)分隔。 元素被转换为字符串,如String.valueOf(Object) ,除非它们本身是数组。

如果元素e是基元类型的数组,则通过调用适当的重载Arrays.toString(e)将其转换为字符串。 如果元素e是引用类型的数组,则通过递归调用此方法将其转换为字符串。

为避免无限递归,如果指定数组包含自身作为元素,或者包含通过一个或多个级别的数组对其自身的间接引用,则自引用将转换为字符串"[...]" 例如,只包含对自身引用的数组将被渲染为"[[...]]"

如果指定数组是 null此方法返回 "null"。

Parameters
a Object: the array whose string representation to return
Returns
String a string representation of a

也可以看看:

equals

Added in API level 1
boolean equals (Object[] a, 
                Object[] a2)

如果两个指定的对象数组相等 ,则返回true 如果两个数组包含相同数量的元素,则两个数组被视为相等,并且两个数组中的所有相应元素对都相等。 两个对象e1e2被视为相等,如果(e1==null ? e2==null : e1.equals(e2)) 换句话说,如果两个数组按照相同的顺序包含相同的元素,则它们是相等的。 另外,如果两个数组都是null ,则两个数组引用被视为相等。

Parameters
a Object: one array to be tested for equality
a2 Object: the other array to be tested for equality
Returns
boolean true if the two arrays are equal

equals

Added in API level 1
boolean equals (double[] a, 
                double[] a2)

如果两个指定的双精度数组相等 ,则返回true 如果两个数组包含相同数量的元素,则两个数组被视为相等,并且两个数组中的所有对应元素对都相等。 换句话说,如果两个数组按照相同的顺序包含相同的元素,则它们是相等的。 另外,如果两个数组都是null,则认为两个数组引用相等。

如果 满足以下 条件 ,两个双打 d1d2被认为是相等的:

    new Double(d1).equals(new Double(d2))
(Unlike the == operator, this method considers NaN equals to itself, and 0.0d unequal to -0.0d.)

Parameters
a double: one array to be tested for equality
a2 double: the other array to be tested for equality
Returns
boolean true if the two arrays are equal

也可以看看:

equals

Added in API level 1
boolean equals (long[] a, 
                long[] a2)

如果两个指定的long数组相等 ,则返回true 如果两个数组包含相同数量的元素,则两个数组被视为相等,并且两个数组中的所有对应元素对都相等。 换句话说,如果两个数组按照相同的顺序包含相同的元素,则它们是相等的。 另外,如果两个数组都是null ,则两个数组引用被视为相等。

Parameters
a long: one array to be tested for equality
a2 long: the other array to be tested for equality
Returns
boolean true if the two arrays are equal

equals

Added in API level 1
boolean equals (char[] a, 
                char[] a2)

如果两个指定的字符数组相等 ,则返回true 如果两个数组包含相同数量的元素,则两个数组被视为相等,并且两个数组中的所有对应元素对都相等。 换句话说,如果两个数组按照相同的顺序包含相同的元素,则它们是相等的。 另外,如果两个数组都是null ,则两个数组引用被视为相等。

Parameters
a char: one array to be tested for equality
a2 char: the other array to be tested for equality
Returns
boolean true if the two arrays are equal

equals

Added in API level 1
boolean equals (boolean[] a, 
                boolean[] a2)

如果两个指定的布尔值数组相等 ,则返回true 如果两个数组包含相同数量的元素,则两个数组被视为相等,并且两个数组中的所有对应元素对都相等。 换句话说,如果两个数组按照相同的顺序包含相同的元素,则它们是相等的。 另外,如果两个数组都是null ,则两个数组引用被视为相等。

Parameters
a boolean: one array to be tested for equality
a2 boolean: the other array to be tested for equality
Returns
boolean true if the two arrays are equal

equals

Added in API level 1
boolean equals (int[] a, 
                int[] a2)

如果两个指定的整数数组相等 ,则返回true 如果两个数组包含相同数量的元素,则两个数组被视为相等,并且两个数组中的所有对应元素对都相等。 换句话说,如果两个数组按照相同的顺序包含相同的元素,则它们是相等的。 另外,如果两个数组都是null ,则两个数组引用被视为相等。

Parameters
a int: one array to be tested for equality
a2 int: the other array to be tested for equality
Returns
boolean true if the two arrays are equal

equals

Added in API level 1
boolean equals (float[] a, 
                float[] a2)

如果两个指定的浮点数组相等 ,则返回true 如果两个数组包含相同数量的元素,则两个数组被视为相等,并且两个数组中的所有对应元素对都相等。 换句话说,如果两个数组按照相同的顺序包含相同的元素,则它们是相等的。 另外,如果两个数组都是null ,则两个数组引用被视为相等。

如果满足以下 条件,则两个浮点数 f1f2被视为相等:

    new Float(f1).equals(new Float(f2))
(Unlike the == operator, this method considers NaN equals to itself, and 0.0f unequal to -0.0f.)

Parameters
a float: one array to be tested for equality
a2 float: the other array to be tested for equality
Returns
boolean true if the two arrays are equal

也可以看看:

equals

Added in API level 1
boolean equals (short[] a, 
                short[] a2)

如果两个指定的短裤阵列彼此相等 ,则返回true 如果两个数组包含相同数量的元素,则两个数组被视为相等,并且两个数组中的所有对应元素对都相等。 换句话说,如果两个数组按照相同的顺序包含相同的元素,则它们是相等的。 此外,如果两个数组都是null ,则两个数组引用被视为相等。

Parameters
a short: one array to be tested for equality
a2 short: the other array to be tested for equality
Returns
boolean true if the two arrays are equal

equals

Added in API level 1
boolean equals (byte[] a, 
                byte[] a2)

如果两个指定的字节数组相等 ,则返回true 如果两个数组包含相同数量的元素,则两个数组被视为相等,并且两个数组中的所有对应元素对都相等。 换句话说,如果两个数组按照相同的顺序包含相同的元素,则它们是相等的。 另外,如果两个数组都是null ,则两个数组引用被视为相等。

Parameters
a byte: one array to be tested for equality
a2 byte: the other array to be tested for equality
Returns
boolean true if the two arrays are equal

fill

Added in API level 1
void fill (float[] a, 
                int fromIndex, 
                int toIndex, 
                float val)

将指定的float值分配给指定float数组指定范围的每个元素。 要填充的范围从索引fromIndex (含)扩展到索引toIndex (不包括)。 (如果fromIndex==toIndex则要填充的范围为空。)

Parameters
a float: the array to be filled
fromIndex int: the index of the first element (inclusive) to be filled with the specified value
toIndex int: the index of the last element (exclusive) to be filled with the specified value
val float: the value to be stored in all elements of the array
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

fill

Added in API level 1
void fill (float[] a, 
                float val)

将指定的浮点值分配给指定的浮点数组的每个元素。

Parameters
a float: the array to be filled
val float: the value to be stored in all elements of the array

fill

Added in API level 1
void fill (byte[] a, 
                int fromIndex, 
                int toIndex, 
                byte val)

将指定的字节值分配给指定字节数组的指定范围内的每个元素。 要填充的范围从索引fromIndex (含)扩展到索引toIndex (不包括)。 (如果fromIndex==toIndex则要填充的范围为空。)

Parameters
a byte: the array to be filled
fromIndex int: the index of the first element (inclusive) to be filled with the specified value
toIndex int: the index of the last element (exclusive) to be filled with the specified value
val byte: the value to be stored in all elements of the array
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

fill

Added in API level 1
void fill (char[] a, 
                char val)

将指定的char值分配给指定的字符数组的每个元素。

Parameters
a char: the array to be filled
val char: the value to be stored in all elements of the array

fill

Added in API level 1
void fill (boolean[] a, 
                int fromIndex, 
                int toIndex, 
                boolean val)

将指定的布尔值指定给指定的布尔数组的指定范围的每个元素。 要填充的范围从索引fromIndex (含)扩展到索引toIndex (不包括)。 (如果fromIndex==toIndex ,要填充的范围是空的。)

Parameters
a boolean: the array to be filled
fromIndex int: the index of the first element (inclusive) to be filled with the specified value
toIndex int: the index of the last element (exclusive) to be filled with the specified value
val boolean: the value to be stored in all elements of the array
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

fill

Added in API level 1
void fill (char[] a, 
                int fromIndex, 
                int toIndex, 
                char val)

将指定的char值分配给指定的字符数组的指定范围的每个元素。 要填充的范围从索引fromIndex (包含)扩展到索引toIndex (不包括)。 (如果fromIndex==toIndex ,要填充的范围是空的。)

Parameters
a char: the array to be filled
fromIndex int: the index of the first element (inclusive) to be filled with the specified value
toIndex int: the index of the last element (exclusive) to be filled with the specified value
val char: the value to be stored in all elements of the array
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

fill

Added in API level 1
void fill (Object[] a, 
                Object val)

将指定的对象引用分配给指定的对象数组的每个元素。

Parameters
a Object: the array to be filled
val Object: the value to be stored in all elements of the array
Throws
ArrayStoreException if the specified value is not of a runtime type that can be stored in the specified array

fill

Added in API level 1
void fill (double[] a, 
                double val)

将指定的double值指定给指定的双精度数组的每个元素。

Parameters
a double: the array to be filled
val double: the value to be stored in all elements of the array

fill

Added in API level 1
void fill (long[] a, 
                long val)

将指定的long值分配给指定的long数组的每个元素。

Parameters
a long: the array to be filled
val long: the value to be stored in all elements of the array

fill

Added in API level 1
void fill (long[] a, 
                int fromIndex, 
                int toIndex, 
                long val)

将指定的long值分配给指定long数组指定范围的每个元素。 要填充的范围从索引fromIndex (含)扩展到索引toIndex (不包括)。 (如果fromIndex==toIndex则要填充的范围为空。)

Parameters
a long: the array to be filled
fromIndex int: the index of the first element (inclusive) to be filled with the specified value
toIndex int: the index of the last element (exclusive) to be filled with the specified value
val long: the value to be stored in all elements of the array
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

fill

Added in API level 1
void fill (byte[] a, 
                byte val)

将指定的字节值分配给指定的字节数组的每个元素。

Parameters
a byte: the array to be filled
val byte: the value to be stored in all elements of the array

fill

Added in API level 1
void fill (int[] a, 
                int fromIndex, 
                int toIndex, 
                int val)

将指定的int值指定给指定的整数数组的指定范围的每个元素。 要填充的范围从索引fromIndex (含)扩展到索引toIndex (仅限于)。 (如果fromIndex==toIndex则要填写的范围为空。)

Parameters
a int: the array to be filled
fromIndex int: the index of the first element (inclusive) to be filled with the specified value
toIndex int: the index of the last element (exclusive) to be filled with the specified value
val int: the value to be stored in all elements of the array
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

fill

Added in API level 1
void fill (double[] a, 
                int fromIndex, 
                int toIndex, 
                double val)

将指定的double值分配给指定的双精度数组的指定范围的每个元素。 要填充的范围从索引fromIndex (含)扩展到索引toIndex (不包括)。 (如果fromIndex==toIndex则要填充的范围为空。)

Parameters
a double: the array to be filled
fromIndex int: the index of the first element (inclusive) to be filled with the specified value
toIndex int: the index of the last element (exclusive) to be filled with the specified value
val double: the value to be stored in all elements of the array
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

fill

Added in API level 1
void fill (short[] a, 
                int fromIndex, 
                int toIndex, 
                short val)

将指定的short值指定给指定短裤数组的指定范围的每个元素。 要填充的范围从索引fromIndex (含)扩展到索引toIndex (仅限于)。 (如果fromIndex==toIndex ,要填充的范围是空的。)

Parameters
a short: the array to be filled
fromIndex int: the index of the first element (inclusive) to be filled with the specified value
toIndex int: the index of the last element (exclusive) to be filled with the specified value
val short: the value to be stored in all elements of the array
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

fill

Added in API level 1
void fill (boolean[] a, 
                boolean val)

将指定的布尔值分配给指定布尔数组的每个元素。

Parameters
a boolean: the array to be filled
val boolean: the value to be stored in all elements of the array

fill

Added in API level 1
void fill (short[] a, 
                short val)

将指定的short值分配给指定短裤阵列的每个元素。

Parameters
a short: the array to be filled
val short: the value to be stored in all elements of the array

fill

Added in API level 1
void fill (Object[] a, 
                int fromIndex, 
                int toIndex, 
                Object val)

将指定的对象引用分配给指定的对象数组的指定范围的每个元素。 要填充的范围从索引fromIndex (含)扩展到索引toIndex (仅限于)。 (如果fromIndex==toIndex则要填充的范围为空。)

Parameters
a Object: the array to be filled
fromIndex int: the index of the first element (inclusive) to be filled with the specified value
toIndex int: the index of the last element (exclusive) to be filled with the specified value
val Object: the value to be stored in all elements of the array
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length
ArrayStoreException if the specified value is not of a runtime type that can be stored in the specified array

fill

Added in API level 1
void fill (int[] a, 
                int val)

将指定的int值分配给指定的整数数组的每个元素。

Parameters
a int: the array to be filled
val int: the value to be stored in all elements of the array

hashCode

Added in API level 1
int hashCode (byte[] a)

根据指定数组的内容返回散列码。 对于任何两个byte阵列ab这样的Arrays.equals(a, b) ,情况也是如此Arrays.hashCode(a) == Arrays.hashCode(b)

此方法返回的值与在hashCode上调用hashCode方法所获得的值相同, List包含Byte实例序列, Byte实例代表a中的元素按相同顺序排列。 如果anull ,则此方法返回0。

Parameters
a byte: the array whose hash value to compute
Returns
int a content-based hash code for a

hashCode

Added in API level 1
int hashCode (boolean[] a)

根据指定数组的内容返回散列码。 对于任何两个boolean阵列ab这样的Arrays.equals(a, b) ,这也是Arrays.hashCode(a) == Arrays.hashCode(b)的情况。

此方法返回的值与通过调用hashCode上的hashCode方法所获得的值相同, List包含Boolean实例序列, Boolean实例代表a中的元素按相同顺序排列。 如果anull ,则此方法返回0。

Parameters
a boolean: the array whose hash value to compute
Returns
int a content-based hash code for a

hashCode

Added in API level 1
int hashCode (char[] a)

根据指定数组的内容返回散列码。 对于任何两个char a阵列和b使得Arrays.equals(a, b),它也是Arrays.hashCode(a) == Arrays.hashCode(b)的情况。

此方法返回的值与在hashCode上调用hashCode方法所获得的值相同, List包含Character实例序列, Character实例代表a中的元素按相同顺序排列。 如果anull ,则此方法返回0。

Parameters
a char: the array whose hash value to compute
Returns
int a content-based hash code for a

hashCode

Added in API level 1
int hashCode (long[] a)

根据指定数组的内容返回散列码。 对于任何两个long阵列ab这样的Arrays.equals(a, b) ,这也是Arrays.hashCode(a) == Arrays.hashCode(b)的情况。

通过此方法返回的值是将通过调用能够得到相同的值hashCode上的方法List含有序列Long实例表示的a以相同顺序的元素。 如果anull ,则此方法返回0。

Parameters
a long: the array whose hash value to compute
Returns
int a content-based hash code for a

hashCode

Added in API level 1
int hashCode (int[] a)

根据指定数组的内容返回散列码。 对于任何两个非空int的数组ab这样的Arrays.equals(a, b) ,这也是Arrays.hashCode(a) == Arrays.hashCode(b)的情况。

此方法返回的值与通过在hashCode上调用hashCode方法所获得的值相同, List包含Integer实例序列, Integer实例代表a中的元素按相同顺序排列。 如果anull ,则此方法返回0。

Parameters
a int: the array whose hash value to compute
Returns
int a content-based hash code for a

hashCode

Added in API level 1
int hashCode (float[] a)

根据指定数组的内容返回散列码。 对于任何两个float阵列ab这样的Arrays.equals(a, b) ,这也是Arrays.hashCode(a) == Arrays.hashCode(b)的情况。

此方法返回的值与在hashCode上调用hashCode方法所获得的值相同, List包含Float实例序列, Float实例代表a中的元素按相同顺序排列。 如果anull ,则此方法返回0。

Parameters
a float: the array whose hash value to compute
Returns
int a content-based hash code for a

hashCode

Added in API level 1
int hashCode (short[] a)

根据指定数组的内容返回散列码。 对于任何两个short a阵列和b使得Arrays.equals(a, b),它也是Arrays.hashCode(a) == Arrays.hashCode(b)的情况。

此方法返回的值与在hashCode上调用hashCode方法所获得的值相同, List包含Short实例序列, Short实例代表a中的元素按相同顺序排列。 如果anull ,则此方法返回0。

Parameters
a short: the array whose hash value to compute
Returns
int a content-based hash code for a

hashCode

Added in API level 1
int hashCode (Object[] a)

根据指定数组的内容返回散列码。 如果数组包含其他数组作为元素,则哈希码基于其身份而不是其内容。 因此,可以接受在包含自身作为元素的数组上调用此方法,可以直接或间接通过一个或多个数组级别进行调用。

对于任何两个数组 ab这样的 Arrays.equals(a, b) ,它也是 Arrays.hashCode(a) == Arrays.hashCode(b)的情况。

此方法返回的值等于 Arrays.asList(a).hashCode()将返回的 ,除非 anull ,在这种情况下返回 0

Parameters
a Object: the array whose content-based hash code to compute
Returns
int a content-based hash code for a

也可以看看:

hashCode

Added in API level 1
int hashCode (double[] a)

根据指定数组的内容返回散列码。 对于任何两个double阵列ab这样的Arrays.equals(a, b) ,这也是Arrays.hashCode(a) == Arrays.hashCode(b)的情况。

此方法返回的值与通过在hashCode上调用hashCode方法所获得的值相同, List包含Double实例序列, Double实例代表a中的元素按相同顺序排列。 如果anull ,则此方法返回0。

Parameters
a double: the array whose hash value to compute
Returns
int a content-based hash code for a

parallelPrefix

Added in API level 24
void parallelPrefix (T[] array, 
                int fromIndex, 
                int toIndex, 
                BinaryOperator<T> op)

针对数组的给定子范围执行 parallelPrefix(Object[], BinaryOperator)

Parameters
array T: the array
fromIndex int: the index of the first element, inclusive
toIndex int: the index of the last element, exclusive
op BinaryOperator: a side-effect-free, associative function to perform the cumulation
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > array.length
NullPointerException if the specified array or function is null

parallelPrefix

Added in API level 24
void parallelPrefix (T[] array, 
                BinaryOperator<T> op)

使用提供的函数并行累积给定数组中的每个元素。 例如,如果该数组最初包含[2, 1, 0, 3]并且该操作执行加法,则在返回时该数组将包含[2, 3, 3, 6] 并行前缀计算通常比大型数组的顺序循环更有效。

Parameters
array T: the array, which is modified in-place by this method
op BinaryOperator: a side-effect-free, associative function to perform the cumulation
Throws
NullPointerException if the specified array or function is null

parallelPrefix

Added in API level 24
void parallelPrefix (long[] array, 
                LongBinaryOperator op)

使用提供的函数并行累积给定数组中的每个元素。 例如,如果数组最初包含[2, 1, 0, 3]并且该操作执行加法,则在返回时数组将包含[2, 3, 3, 6] 并行前缀计算通常比大型数组的顺序循环更有效。

Parameters
array long: the array, which is modified in-place by this method
op LongBinaryOperator: a side-effect-free, associative function to perform the cumulation
Throws
NullPointerException if the specified array or function is null

parallelPrefix

Added in API level 24
void parallelPrefix (long[] array, 
                int fromIndex, 
                int toIndex, 
                LongBinaryOperator op)

对数组的给定子范围执行 parallelPrefix(long[], LongBinaryOperator)

Parameters
array long: the array
fromIndex int: the index of the first element, inclusive
toIndex int: the index of the last element, exclusive
op LongBinaryOperator: a side-effect-free, associative function to perform the cumulation
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > array.length
NullPointerException if the specified array or function is null

parallelPrefix

Added in API level 24
void parallelPrefix (int[] array, 
                int fromIndex, 
                int toIndex, 
                IntBinaryOperator op)

针对数组的给定子范围执行 parallelPrefix(int[], IntBinaryOperator)

Parameters
array int: the array
fromIndex int: the index of the first element, inclusive
toIndex int: the index of the last element, exclusive
op IntBinaryOperator: a side-effect-free, associative function to perform the cumulation
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > array.length
NullPointerException if the specified array or function is null

parallelPrefix

Added in API level 24
void parallelPrefix (double[] array, 
                int fromIndex, 
                int toIndex, 
                DoubleBinaryOperator op)

对数组的给定子范围执行 parallelPrefix(double[], DoubleBinaryOperator)

Parameters
array double: the array
fromIndex int: the index of the first element, inclusive
toIndex int: the index of the last element, exclusive
op DoubleBinaryOperator: a side-effect-free, associative function to perform the cumulation
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > array.length
NullPointerException if the specified array or function is null

parallelPrefix

Added in API level 24
void parallelPrefix (double[] array, 
                DoubleBinaryOperator op)

使用提供的函数并行累积给定数组中的每个元素。 例如,如果数组最初包含[2.0, 1.0, 0.0, 3.0]并且该操作执行加法,则返回时数组将包含[2.0, 3.0, 3.0, 6.0] 并行前缀计算通常比大型数组的顺序循环更有效。

由于浮点运算可能不是严格关联的,因此返回的结果可能与顺序执行操作时得到的值不同。

Parameters
array double: the array, which is modified in-place by this method
op DoubleBinaryOperator: a side-effect-free function to perform the cumulation
Throws
NullPointerException if the specified array or function is null

parallelPrefix

Added in API level 24
void parallelPrefix (int[] array, 
                IntBinaryOperator op)

使用提供的函数并行累积给定数组中的每个元素。 例如,如果数组最初保存[2, 1, 0, 3]并且操作执行加法,则返回时数组将保存[2, 3, 3, 6] 并行前缀计算通常比大型数组的顺序循环更有效。

Parameters
array int: the array, which is modified in-place by this method
op IntBinaryOperator: a side-effect-free, associative function to perform the cumulation
Throws
NullPointerException if the specified array or function is null

parallelSetAll

Added in API level 24
void parallelSetAll (double[] array, 
                IntToDoubleFunction generator)

使用提供的生成器函数并行设置指定数组的所有元素来计算每个元素。

如果生成器函数抛出异常,则从 parallelSetAll抛出未经检查的异常,并且该数组处于不确定状态。

Parameters
array double: array to be initialized
generator IntToDoubleFunction: a function accepting an index and producing the desired value for that position
Throws
NullPointerException if the generator is null

parallelSetAll

Added in API level 24
void parallelSetAll (int[] array, 
                IntUnaryOperator generator)

使用提供的生成器函数并行设置指定数组的所有元素来计算每个元素。

如果生成器函数抛出异常,则从 parallelSetAll抛出未经检查的异常,并且该数组处于不确定状态。

Parameters
array int: array to be initialized
generator IntUnaryOperator: a function accepting an index and producing the desired value for that position
Throws
NullPointerException if the generator is null

parallelSetAll

Added in API level 24
void parallelSetAll (long[] array, 
                IntToLongFunction generator)

使用提供的生成器函数并行设置指定数组的所有元素来计算每个元素。

如果生成器函数抛出异常,则会从 parallelSetAll引发未检查的异常,并且该数组处于不确定状态。

Parameters
array long: array to be initialized
generator IntToLongFunction: a function accepting an index and producing the desired value for that position
Throws
NullPointerException if the generator is null

parallelSetAll

Added in API level 24
void parallelSetAll (T[] array, 
                IntFunction<? extends T> generator)

使用提供的生成器函数并行设置指定数组的所有元素来计算每个元素。

如果生成器函数抛出异常,则从 parallelSetAll抛出未经检查的异常,并且数组处于不确定状态。

Parameters
array T: array to be initialized
generator IntFunction: a function accepting an index and producing the desired value for that position
Throws
NullPointerException if the generator is null

parallelSort

Added in API level 24
void parallelSort (T[] a, 
                Comparator<? super T> cmp)

根据指定比较器引发的顺序对指定的对象数组进行排序。 数组中的所有元素必须可以通过指定的比较器进行相互比较(也就是说, c.compare(e1, e2) ClassCastException中的任何元素e1e2不得抛出ClassCastException )。

这种保证是 稳定的 :相同的元素不会因排序而重新排序。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a T: the array to be sorted
cmp Comparator: the comparator to determine the order of the array. A null value indicates that the elements' natural ordering should be used.
Throws
ClassCastException if the array contains elements that are not mutually comparable using the specified comparator
IllegalArgumentException (optional) if the comparator is found to violate the Comparator contract

parallelSort

Added in API level 24
void parallelSort (long[] a)

按指定的数字顺序将指定的数组排序。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a long: the array to be sorted

parallelSort

Added in API level 24
void parallelSort (short[] a)

按指定的数字顺序将指定的数组排序。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a short: the array to be sorted

parallelSort

Added in API level 24
void parallelSort (double[] a)

按指定的数字顺序将指定的数组排序。

所述<关系不能在所有的双精度值提供一个总次序: -0.0d == 0.0dtrueDouble.NaN值进行比较既不小于,大于,也不等于任何值,甚至本身。 此方法使用由该方法所施加的总订单compareTo(T)-0.0d被视为小于值0.0dDouble.NaN比任何其他值考虑更大,并且所有Double.NaN值被认为是相等的。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a double: the array to be sorted

parallelSort

Added in API level 24
void parallelSort (char[] a)

按指定的数字顺序将指定的数组排序。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a char: the array to be sorted

parallelSort

Added in API level 24
void parallelSort (double[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序编号排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (排除)。 如果fromIndex == toIndex ,要排序的范围是空的。

所述<关系不能在所有的双精度值提供一个总次序: -0.0d == 0.0dtrueDouble.NaN值进行比较既不小于,大于,也不等于任何值,甚至本身。 此方法使用方法compareTo(T)施加的总顺序: -0.0d被视为小于值0.0d并且Double.NaN被视为大于任何其他值,并且所有Double.NaN值都被视为相等。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the specified range of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a double: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

parallelSort

Added in API level 24
void parallelSort (T[] a)

根据元素的natural ordering将指定的对象数组按照升序排序。 阵列中的所有元素必须实现Comparable接口。 此外,数组中的所有元素必须相互可比 (即, e1.compareTo(e2)不得为ClassCastException中的任何元素e1e2抛出ClassCastException )。

这种保证是 稳定的 :相同的元素不会因排序而重新排序。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a T: the array to be sorted
Throws
ClassCastException if the array contains elements that are not mutually comparable (for example, strings and integers)
IllegalArgumentException (optional) if the natural ordering of the array elements is found to violate the Comparable contract

parallelSort

Added in API level 24
void parallelSort (float[] a)

按指定的数字顺序将指定的数组排序。

<关系不提供所有浮点值的全部订单: -0.0f == 0.0ftrue并且Float.NaN值与既不是Float.NaN值也不小于,大于或等于任何值都相比较。 此方法使用方法compareTo(T)施加的总顺序: -0.0f被视为小于值0.0f并且Float.NaN被视为大于任何其他值,并且所有Float.NaN值都被视为相等。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a float: the array to be sorted

parallelSort

Added in API level 24
void parallelSort (byte[] a)

按指定的数字顺序将指定的数组排序。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a byte: the array to be sorted

parallelSort

Added in API level 24
void parallelSort (char[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序编号排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (排除)。 如果fromIndex == toIndex ,要排序的范围是空的。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the specified range of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a char: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

parallelSort

Added in API level 24
void parallelSort (int[] a)

按指定的数字顺序将指定的数组排序。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a int: the array to be sorted

parallelSort

Added in API level 24
void parallelSort (long[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序编号排序。 要排序的范围从索引fromIndex (含)延伸至索引toIndex (排除)。 如果fromIndex == toIndex ,要排序的范围为空。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the specified range of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a long: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

parallelSort

Added in API level 24
void parallelSort (float[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序编号排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (排除)。 如果fromIndex == toIndex ,要排序的范围是空的。

<关系不会为所有浮点值提供全部订单: -0.0f == 0.0ftrueFloat.NaN值与任何值(即使其本身)的比较都不小于,大于或等于任何值。 该方法使用方法compareTo(T)施加的总顺序: -0.0f被视为小于值0.0f并且Float.NaN被认为大于任何其他值,并且所有Float.NaN值被认为是相等的。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the specified range of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a float: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

parallelSort

Added in API level 24
void parallelSort (int[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序编号排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (排他)。 如果fromIndex == toIndex ,要排序的范围是空的。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the specified range of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a int: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

parallelSort

Added in API level 24
void parallelSort (byte[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序编号排序。 要排序的范围从索引fromIndex (含)延伸到索引toIndex (排除)。 如果fromIndex == toIndex ,要排序的范围为空。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the specified range of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a byte: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

parallelSort

Added in API level 24
void parallelSort (short[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序编号排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (排除)。 如果fromIndex == toIndex ,要排序的范围为空。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the specified range of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a short: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

parallelSort

Added in API level 24
void parallelSort (T[] a, 
                int fromIndex, 
                int toIndex)

根据其元素的natural ordering ,将指定的对象数组的指定范围按升序排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (不包括)。 (如果fromIndex==toIndex ,要排序的范围为空。)此范围内的所有元素必须实现Comparable接口。 此外,此范围内的所有元素必须相互可比 (即, e1.compareTo(e2)不得为ClassCastException中的任何元素e1e2抛出ClassCastException )。

这种保证是 稳定的 :相同的元素不会因排序而重新排序。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the specified range of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a T: the array to be sorted
fromIndex int: the index of the first element (inclusive) to be sorted
toIndex int: the index of the last element (exclusive) to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex or (optional) if the natural ordering of the array elements is found to violate the Comparable contract
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length
ClassCastException if the array contains elements that are not mutually comparable (for example, strings and integers).

parallelSort

Added in API level 24
void parallelSort (T[] a, 
                int fromIndex, 
                int toIndex, 
                Comparator<? super T> cmp)

根据指定比较器引发的顺序对指定的对象数组的指定范围进行排序。 要排序的范围从索引fromIndex (含)延伸到索引toIndex (排除)。 (如果fromIndex==toIndex ,则排序范围为空。)范围内的所有元素都必须是指定比较相互比较的 (即, c.compare(e1, e2)不得抛出ClassCastException任何元件e1e2在范围内)。

这种保证是 稳定的 :相同的元素不会因排序而重新排序。

Implementation Note:
  • The sorting algorithm is a parallel sort-merge that breaks the array into sub-arrays that are themselves sorted and then merged. When the sub-array length reaches a minimum granularity, the sub-array is sorted using the appropriate Arrays.sort method. If the length of the specified array is less than the minimum granularity, then it is sorted using the appropriate Arrays.sort method. The algorithm requires a working space no greater than the size of the specified range of the original array. The ForkJoin common pool is used to execute any parallel tasks.
Parameters
a T: the array to be sorted
fromIndex int: the index of the first element (inclusive) to be sorted
toIndex int: the index of the last element (exclusive) to be sorted
cmp Comparator: the comparator to determine the order of the array. A null value indicates that the elements' natural ordering should be used.
Throws
IllegalArgumentException if fromIndex > toIndex or (optional) if the natural ordering of the array elements is found to violate the Comparable contract
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length
ClassCastException if the array contains elements that are not mutually comparable (for example, strings and integers).

setAll

Added in API level 24
void setAll (T[] array, 
                IntFunction<? extends T> generator)

设置指定数组的所有元素,使用提供的生成器函数来计算每个元素。

如果生成器函数抛出一个异常,它会中继给调用者,并且数组处于不确定状态。

Parameters
array T: array to be initialized
generator IntFunction: a function accepting an index and producing the desired value for that position
Throws
NullPointerException if the generator is null

setAll

Added in API level 24
void setAll (double[] array, 
                IntToDoubleFunction generator)

设置指定数组的所有元素,使用提供的生成器函数来计算每个元素。

如果生成器函数抛出一个异常,它会中继给调用者,并且数组处于不确定状态。

Parameters
array double: array to be initialized
generator IntToDoubleFunction: a function accepting an index and producing the desired value for that position
Throws
NullPointerException if the generator is null

setAll

Added in API level 24
void setAll (long[] array, 
                IntToLongFunction generator)

设置指定数组的所有元素,使用提供的生成器函数来计算每个元素。

如果生成器函数抛出一个异常,它会中继给调用者,并且数组处于不确定状态。

Parameters
array long: array to be initialized
generator IntToLongFunction: a function accepting an index and producing the desired value for that position
Throws
NullPointerException if the generator is null

setAll

Added in API level 24
void setAll (int[] array, 
                IntUnaryOperator generator)

设置指定数组的所有元素,使用提供的生成器函数来计算每个元素。

如果生成器函数抛出一个异常,它会中继给调用者,并且数组处于不确定状态。

Parameters
array int: array to be initialized
generator IntUnaryOperator: a function accepting an index and producing the desired value for that position
Throws
NullPointerException if the generator is null

sort

Added in API level 1
void sort (T[] a, 
                int fromIndex, 
                int toIndex, 
                Comparator<? super T> c)

根据指定比较器引发的顺序对指定的对象数组的指定范围进行排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (排除)。 (如果fromIndex==toIndex ,则排序范围为空。)范围内的所有元素都必须是指定比较相互比较的 (即, c.compare(e1, e2)不得抛出ClassCastException任何元件e1e2在范围内)。

这种保证是 稳定的 :相同的元素不会因排序而重新排序。

实现注意事项:这个实现是一个稳定的自适应迭代mergesort,当输入数组部分排序时,需要远远少于n lg(n)的比较,同时在输入数组是随机排序时提供传统mergesort的性能。 如果输入数组几乎排序,则实现需要大约n次比较。 临时存储要求从几乎排序的输入数组的小常量到随机排序的输入数组的n / 2个对象引用。

该实现在输入数组中具有升序和降序的相等优势,并且可以利用相同输入数组的不同部分中的升序和降序。 它非常适合合并两个或多个有序数组:简单地连接数组并对结果数组进行排序。

这个实现是根据Tim Peters的Python列表排序进行的( TimSort )。 它使用Peter McIlroy的“Optimistic Sorting and Information Theoretic Complexity”中的技术,在Proceedings of the Fourth Annual ACM-SIAM Symposium on Discrete Algorithms,第467-474页,1993年1月。

Parameters
a T: the array to be sorted
fromIndex int: the index of the first element (inclusive) to be sorted
toIndex int: the index of the last element (exclusive) to be sorted
c Comparator: the comparator to determine the order of the array. A null value indicates that the elements' natural ordering should be used.
Throws
ClassCastException if the array contains elements that are not mutually comparable using the specified comparator.
IllegalArgumentException if fromIndex > toIndex or (optional) if the comparator is found to violate the Comparator contract
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

sort

Added in API level 1
void sort (int[] a)

按指定的数字顺序将指定的数组排序。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a int: the array to be sorted

sort

Added in API level 1
void sort (long[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (排他)。 如果fromIndex == toIndex ,要排序的范围是空的。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a long: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

sort

Added in API level 1
void sort (double[] a)

按指定的数字顺序将指定的数组排序。

<关系不会提供所有双-0.0d == 0.0d值的全部命令: -0.0d == 0.0dtrue并且Double.NaN值与任何值(即使它本身)的比较都不小于,大于或等于任何值。 该方法使用由方法compareTo(T)施加的总顺序: -0.0d被视为小于值0.0d并且Double.NaN被认为大于任何其他值并且所有Double.NaN值被认为是相等的。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a double: the array to be sorted

sort

Added in API level 1
void sort (short[] a)

按指定的数字顺序将指定的数组排序。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a short: the array to be sorted

sort

Added in API level 1
void sort (char[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (排除)。 如果fromIndex == toIndex ,要排序的范围是空的。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a char: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

sort

Added in API level 1
void sort (long[] a)

按指定的数字顺序将指定的数组排序。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a long: the array to be sorted

sort

Added in API level 1
void sort (float[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (不包括)。 如果fromIndex == toIndex ,要排序的范围为空。

<关系不会提供所有浮点值的全部订单: -0.0f == 0.0ftrue并且Float.NaN值与任何值(即使其自身)的比较都不小于,大于或等于任何值。 此方法使用方法compareTo(T)施加的总顺序: -0.0f被视为小于值0.0fFloat.NaN被视为大于任何其他值,并且所有Float.NaN值都被视为相等。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a float: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

sort

Added in API level 1
void sort (short[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序排序。 要排序的范围从索引fromIndex (含)延伸到索引toIndex (排他)。 如果fromIndex == toIndex ,要排序的范围为空。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a short: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

sort

Added in API level 1
void sort (T[] a, 
                Comparator<? super T> c)

根据指定比较器引发的顺序对指定的对象数组进行排序。 数组中的所有元素必须可以通过指定的比较器进行相互比较(也就是说, c.compare(e1, e2) ClassCastException中的任何元素e1e2不得抛出ClassCastException )。

这种保证是 稳定的 :相同的元素不会因排序而重新排序。

实现注意事项:这个实现是一个稳定的自适应迭代mergesort,当输入数组部分排序时,需要远远少于n lg(n)的比较,同时在输入数组是随机排序时提供传统mergesort的性能。 如果输入数组几乎排序,则实现需要大约n次比较。 临时存储要求从几乎排序的输入数组的小常量到随机排序的输入数组的n / 2个对象引用。

该实现在输入数组中具有升序和降序的相等优势,并且可以利用相同输入数组的不同部分中的升序和降序。 它非常适合合并两个或多个有序数组:简单地连接数组并对结果数组进行排序。

这个实现是根据Tim Peters的Python列表排序( TimSort )改编的。 它使用Peter McIlroy的“Optimistic Sorting and Information Theoretic Complexity”中的技术,在Proceedings of the Fourth Annual ACM-SIAM Symposium on Discrete Algorithms,第467-474页,1993年1月。

Parameters
a T: the array to be sorted
c Comparator: the comparator to determine the order of the array. A null value indicates that the elements' natural ordering should be used.
Throws
ClassCastException if the array contains elements that are not mutually comparable using the specified comparator
IllegalArgumentException (optional) if the comparator is found to violate the Comparator contract

sort

Added in API level 1
void sort (byte[] a)

按指定的数字顺序将指定的数组排序。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a byte: the array to be sorted

sort

Added in API level 1
void sort (Object[] a, 
                int fromIndex, 
                int toIndex)

根据其元素的natural ordering ,将指定的对象数组的指定范围按升序排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (不包括)。 (如果fromIndex==toIndex ,要排序的范围为空)。此范围内的所有元素都必须实现Comparable接口。 此外,此范围内的所有元素必须相互可比 (即, e1.compareTo(e2)不得为ClassCastException中的任何元素e1e2抛出ClassCastException )。

这种保证是 稳定的 :相同的元素不会因排序而重新排序。

实现注意事项:这个实现是一个稳定的自适应迭代mergesort,当输入数组部分排序时,需要远远少于n lg(n)的比较,同时在输入数组是随机排序时提供传统mergesort的性能。 如果输入数组几乎排序,则实现需要大约n次比较。 临时存储要求从几乎排序的输入数组的小常量到随机排序的输入数组的n / 2个对象引用。

该实现在输入数组中具有升序和降序的相等优势,并且可以利用相同输入数组的不同部分中的升序和降序。 它非常适合合并两个或多个有序数组:简单地连接数组并对结果数组进行排序。

这个实现是根据Tim Peters的Python列表排序进行的( TimSort )。 它使用Peter McIlroy的“Optimistic Sorting and Information Theoretic Complexity”中的技术,在Proceedings of the Fourth Annual ACM-SIAM Symposium on Discrete Algorithms,第467-474页,1993年1月。

Parameters
a Object: the array to be sorted
fromIndex int: the index of the first element (inclusive) to be sorted
toIndex int: the index of the last element (exclusive) to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex or (optional) if the natural ordering of the array elements is found to violate the Comparable contract
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length
ClassCastException if the array contains elements that are not mutually comparable (for example, strings and integers).

sort

Added in API level 1
void sort (char[] a)

按指定的数字顺序将指定的数组排序。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a char: the array to be sorted

sort

Added in API level 1
void sort (double[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (排除)。 如果fromIndex == toIndex ,要排序的范围是空的。

<关系不会在所有双-0.0d == 0.0d值上提供全部的顺序: -0.0d == 0.0dtrue并且Double.NaN值与既不是Double.NaN值也不小于,大于或等于任何值都是相同的。 该方法使用由方法compareTo(T)施加的总顺序: -0.0d被视为小于值0.0d并且Double.NaN被认为大于任何其他值并且所有Double.NaN值被视为相等。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a double: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

sort

Added in API level 1
void sort (Object[] a)

根据其元素的natural ordering将指定的对象数组按照升序排序。 阵列中的所有元素必须实现Comparable接口。 此外,数组中的所有元素都必须相互可比 (即, e1.compareTo(e2)不得为ClassCastException中的任何元素e1e2抛出ClassCastException )。

这种保证是 稳定的 :相同的元素不会因排序而重新排序。

实现注意事项:这个实现是一个稳定的自适应迭代mergesort,当输入数组部分排序时,需要远远少于n lg(n)的比较,同时在输入数组是随机排序时提供传统mergesort的性能。 如果输入数组几乎排序,则实现需要大约n次比较。 临时存储要求从几乎排序的输入数组的小常量到随机排序的输入数组的n / 2个对象引用。

该实现在输入数组中具有升序和降序的相等优势,并且可以利用相同输入数组的不同部分中的升序和降序。 它非常适合合并两个或多个有序数组:简单地连接数组并对结果数组进行排序。

这个实现是根据Tim Peters的Python列表排序( TimSort )改编的。 它使用Peter McIlroy的“Optimistic Sorting and Information Theoretic Complexity”中的技术,在Proceedings of the Fourth Annual ACM-SIAM Symposium on Discrete Algorithms,第467-474页,1993年1月。

Parameters
a Object: the array to be sorted
Throws
ClassCastException if the array contains elements that are not mutually comparable (for example, strings and integers)
IllegalArgumentException (optional) if the natural ordering of the array elements is found to violate the Comparable contract

sort

Added in API level 1
void sort (int[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序排序。 要排序的范围从索引fromIndex (含)延伸至索引toIndex (排除)。 如果fromIndex == toIndex ,要排序的范围是空的。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a int: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

sort

Added in API level 1
void sort (byte[] a, 
                int fromIndex, 
                int toIndex)

将数组的指定范围按升序排序。 要排序的范围从索引fromIndex (含)扩展到索引toIndex (排除)。 如果fromIndex == toIndex ,要排序的范围是空的。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a byte: the array to be sorted
fromIndex int: the index of the first element, inclusive, to be sorted
toIndex int: the index of the last element, exclusive, to be sorted
Throws
IllegalArgumentException if fromIndex > toIndex
ArrayIndexOutOfBoundsException if fromIndex < 0 or toIndex > a.length

sort

Added in API level 1
void sort (float[] a)

按指定的数字顺序将指定的数组排序。

<关系不会提供所有浮点值的全部订单: -0.0f == 0.0ftrue并且Float.NaN值与任何值(即使其自身)的比较都不小于,大于或等于任何值。 此方法使用方法compareTo(T)施加的总顺序: -0.0f被视为小于值0.0f并且Float.NaN被视为大于任何其他值,并且所有Float.NaN值被视为相等。

实现注释:排序算法是由Vladimir Yaroslavskiy,Jon Bentley和Joshua Bloch编写的Dual-Pivot Quicksort。 该算法在许多数据集上提供O(n log(n))性能,这些数据集导致其他快速排序降级为二次性能,并且通常比传统的(单枢纽)Quicksort实现更快。

Parameters
a float: the array to be sorted

spliterator

Added in API level 24
Spliterator.OfLong spliterator (long[] array, 
                int startInclusive, 
                int endExclusive)

返回覆盖指定数组的指定范围的 Spliterator.OfLong

该报告spliterator SIZEDSUBSIZEDORDERED ,并 IMMUTABLE

Parameters
array long: the array, assumed to be unmodified during use
startInclusive int: the first index to cover, inclusive
endExclusive int: index immediately past the last index to cover
Returns
Spliterator.OfLong a spliterator for the array elements
Throws
ArrayIndexOutOfBoundsException if startInclusive is negative, endExclusive is less than startInclusive, or endExclusive is greater than the array size

spliterator

Added in API level 24
Spliterator.OfLong spliterator (long[] array)

返回涵盖所有指定数组的 Spliterator.OfLong

该报告spliterator SIZEDSUBSIZEDORDERED ,并 IMMUTABLE

Parameters
array long: the array, assumed to be unmodified during use
Returns
Spliterator.OfLong the spliterator for the array elements

spliterator

Added in API level 24
Spliterator.OfDouble spliterator (double[] array)

返回涵盖所有指定数组的 Spliterator.OfDouble

该报告spliterator SIZEDSUBSIZEDORDERED ,并 IMMUTABLE

Parameters
array double: the array, assumed to be unmodified during use
Returns
Spliterator.OfDouble a spliterator for the array elements

spliterator

Added in API level 24
Spliterator.OfInt spliterator (int[] array, 
                int startInclusive, 
                int endExclusive)

返回覆盖指定数组的指定范围的 Spliterator.OfInt

该报告spliterator SIZEDSUBSIZEDORDERED ,并 IMMUTABLE

Parameters
array int: the array, assumed to be unmodified during use
startInclusive int: the first index to cover, inclusive
endExclusive int: index immediately past the last index to cover
Returns
Spliterator.OfInt a spliterator for the array elements
Throws
ArrayIndexOutOfBoundsException if startInclusive is negative, endExclusive is less than startInclusive, or endExclusive is greater than the array size

spliterator

Added in API level 24
Spliterator<T> spliterator (T[] array)

返回覆盖所有指定数组的 Spliterator

该报告spliterator SIZEDSUBSIZEDORDERED ,并 IMMUTABLE

Parameters
array T: the array, assumed to be unmodified during use
Returns
Spliterator<T> a spliterator for the array elements

spliterator

Added in API level 24
Spliterator.OfInt spliterator (int[] array)

返回涵盖所有指定数组的 Spliterator.OfInt

该报告spliterator SIZEDSUBSIZEDORDERED ,并 IMMUTABLE

Parameters
array int: the array, assumed to be unmodified during use
Returns
Spliterator.OfInt a spliterator for the array elements

spliterator

Added in API level 24
Spliterator<T> spliterator (T[] array, 
                int startInclusive, 
                int endExclusive)

返回覆盖指定数组的指定范围的 Spliterator

该报告spliterator SIZEDSUBSIZEDORDERED ,并 IMMUTABLE

Parameters
array T: the array, assumed to be unmodified during use
startInclusive int: the first index to cover, inclusive
endExclusive int: index immediately past the last index to cover
Returns
Spliterator<T> a spliterator for the array elements
Throws
ArrayIndexOutOfBoundsException if startInclusive is negative, endExclusive is less than startInclusive, or endExclusive is greater than the array size

spliterator

Added in API level 24
Spliterator.OfDouble spliterator (double[] array, 
                int startInclusive, 
                int endExclusive)

返回覆盖指定数组的指定范围的 Spliterator.OfDouble

该报告spliterator SIZEDSUBSIZEDORDERED ,并 IMMUTABLE

Parameters
array double: the array, assumed to be unmodified during use
startInclusive int: the first index to cover, inclusive
endExclusive int: index immediately past the last index to cover
Returns
Spliterator.OfDouble a spliterator for the array elements
Throws
ArrayIndexOutOfBoundsException if startInclusive is negative, endExclusive is less than startInclusive, or endExclusive is greater than the array size

stream

Added in API level 24
IntStream stream (int[] array)

以指定数组作为源返回顺序 IntStream

Parameters
array int: the array, assumed to be unmodified during use
Returns
IntStream an IntStream for the array

stream

Added in API level 24
LongStream stream (long[] array)

返回指定数组作为其源的顺序 LongStream

Parameters
array long: the array, assumed to be unmodified during use
Returns
LongStream a LongStream for the array

stream

Added in API level 24
Stream<T> stream (T[] array)

返回指定数组作为其源的顺序 Stream

Parameters
array T: The array, assumed to be unmodified during use
Returns
Stream<T> a Stream for the array

stream

Added in API level 24
DoubleStream stream (double[] array, 
                int startInclusive, 
                int endExclusive)

以指定数组的指定范围作为其源,返回顺序 DoubleStream

Parameters
array double: the array, assumed to be unmodified during use
startInclusive int: the first index to cover, inclusive
endExclusive int: index immediately past the last index to cover
Returns
DoubleStream a DoubleStream for the array range
Throws
ArrayIndexOutOfBoundsException if startInclusive is negative, endExclusive is less than startInclusive, or endExclusive is greater than the array size

stream

Added in API level 24
DoubleStream stream (double[] array)

返回指定数组作为其源的顺序 DoubleStream

Parameters
array double: the array, assumed to be unmodified during use
Returns
DoubleStream a DoubleStream for the array

stream

Added in API level 24
IntStream stream (int[] array, 
                int startInclusive, 
                int endExclusive)

返回指定数组的指定范围作为其源的顺序 IntStream

Parameters
array int: the array, assumed to be unmodified during use
startInclusive int: the first index to cover, inclusive
endExclusive int: index immediately past the last index to cover
Returns
IntStream an IntStream for the array range
Throws
ArrayIndexOutOfBoundsException if startInclusive is negative, endExclusive is less than startInclusive, or endExclusive is greater than the array size

stream

Added in API level 24
Stream<T> stream (T[] array, 
                int startInclusive, 
                int endExclusive)

以指定数组的指定范围作为源返回顺序 Stream

Parameters
array T: the array, assumed to be unmodified during use
startInclusive int: the first index to cover, inclusive
endExclusive int: index immediately past the last index to cover
Returns
Stream<T> a Stream for the array range
Throws
ArrayIndexOutOfBoundsException if startInclusive is negative, endExclusive is less than startInclusive, or endExclusive is greater than the array size

stream

Added in API level 24
LongStream stream (long[] array, 
                int startInclusive, 
                int endExclusive)

返回指定数组的指定范围作为其源的顺序 LongStream

Parameters
array long: the array, assumed to be unmodified during use
startInclusive int: the first index to cover, inclusive
endExclusive int: index immediately past the last index to cover
Returns
LongStream a LongStream for the array range
Throws
ArrayIndexOutOfBoundsException if startInclusive is negative, endExclusive is less than startInclusive, or endExclusive is greater than the array size

toString

Added in API level 1
String toString (float[] a)

返回指定数组内容的字符串表示形式。 字符串表示由数组元素的列表组成,方括号( "[]" )。 相邻元素由字符", " (逗号后跟一个空格)分隔。 元素被转换为字符串,如String.valueOf(float) 返回"null"如果anull。

Parameters
a float: the array whose string representation to return
Returns
String a string representation of a

toString

Added in API level 1
String toString (int[] a)

返回指定数组内容的字符串表示形式。 字符串表示由数组元素的列表组成,方括号( "[]" )。 相邻的元素由字符", " (逗号后跟一个空格)分隔。 元素通过String.valueOf(int)转换为字符串。 返回"null"如果anull。

Parameters
a int: the array whose string representation to return
Returns
String a string representation of a

toString

Added in API level 1
String toString (Object[] a)

返回指定数组内容的字符串表示形式。 如果数组包含其它数组作为元件,它们被转换为字符串toString()Object继承的方法,其描述了他们的身份 ,而不是其内容。

此方法返回的值等于将返回 Arrays.asList(a).toString()的值,除非 anull ,在这种情况下返回 "null"

Parameters
a Object: the array whose string representation to return
Returns
String a string representation of a

也可以看看:

toString

Added in API level 1
String toString (long[] a)

返回指定数组内容的字符串表示形式。 字符串表示由数组元素的列表组成,方括号( "[]" )。 相邻元素由字符", " (逗号后跟空格)分隔。 元素被转换为字符串,如String.valueOf(long) 返回"null"如果anull。

Parameters
a long: the array whose string representation to return
Returns
String a string representation of a

toString

Added in API level 1
String toString (boolean[] a)

返回指定数组内容的字符串表示形式。 字符串表示由数组元素的列表组成,方括号( "[]" )。 相邻元素由字符", " (逗号后跟一个空格)分隔。 元素通过String.valueOf(boolean)转换为字符串。 返回"null"如果anull。

Parameters
a boolean: the array whose string representation to return
Returns
String a string representation of a

toString

Added in API level 1
String toString (double[] a)

返回指定数组内容的字符串表示形式。 字符串表示由数组元素的列表组成,方括号( "[]" )。 相邻元素由字符", " (逗号后跟一个空格)分隔。 元素被转换为字符串,如String.valueOf(double) 返回"null"如果anull。

Parameters
a double: the array whose string representation to return
Returns
String a string representation of a

toString

Added in API level 1
String toString (short[] a)

返回指定数组内容的字符串表示形式。 字符串表示由数组元素的列表组成,方括号( "[]" )。 相邻元素由字符", " (逗号后跟一个空格)分隔。 元素被转换为字符串,如String.valueOf(short) 返回"null"如果anull。

Parameters
a short: the array whose string representation to return
Returns
String a string representation of a

toString

Added in API level 1
String toString (char[] a)

返回指定数组内容的字符串表示形式。 字符串表示由数组元素的列表组成,方括号( "[]" )。 相邻的元素由字符", " (逗号后跟一个空格)分隔。 元素被转换为字符串,如String.valueOf(char) 返回"null"如果anull。

Parameters
a char: the array whose string representation to return
Returns
String a string representation of a

toString

Added in API level 1
String toString (byte[] a)

返回指定数组内容的字符串表示形式。 字符串表示由数组元素的列表组成,方括号( "[]" )。 相邻元素由字符", " (逗号后跟一个空格)分隔。 元素通过String.valueOf(byte)转换为字符串。 返回"null"如果anull。

Parameters
a byte: the array whose string representation to return
Returns
String a string representation of a

Hooray!