鴻蒙OS Arrays

2022-07-11 14:44 更新

Arrays

java.lang.Object

|---java.util.Arrays

public class Arrays
extends Object

此類包含用于操作數(shù)組(例如排序和搜索)的各種方法。 此類還包含一個允許將數(shù)組視為列表的靜態(tài)工廠。

如果指定的數(shù)組引用為空,則此類中的方法都會拋出 NullPointerException,除非另有說明。

此類中包含的方法的文檔包括實現(xiàn)的簡要說明。 此類描述應(yīng)被視為實現(xiàn)說明,而不是規(guī)范的一部分。 只要遵守規(guī)范本身,實現(xiàn)者應(yīng)該可以隨意替換其他算法。 (例如,sort(Object[]) 使用的算法不必是 MergeSort,但它必須是穩(wěn)定的。)

此類是 Java 集合框架的成員。

方法總結(jié)

修飾符和類型 方法 描述
static <T> List<T> asList(T... a) 返回由指定數(shù)組支持的固定大小的列表。
static int binarySearch(byte[] a, byte key) 使用二進(jìn)制搜索算法在指定的字節(jié)數(shù)組中搜索指定的值。
static int binarySearch(byte[] a, int fromIndex, int toIndex, byte key) 使用二進(jìn)制搜索算法在指定字節(jié)數(shù)組的范圍內(nèi)搜索指定值。
static int binarySearch(char[] a, char key) 使用二進(jìn)制搜索算法在指定的字符數(shù)組中搜索指定的值。
static int binarySearch(char[] a, int fromIndex, int toIndex, char key) 使用二進(jìn)制搜索算法在指定字符數(shù)組的范圍內(nèi)搜索指定值。
static int binarySearch(double[] a, double key) 使用二進(jìn)制搜索算法在指定的雙精度數(shù)組中搜索指定的值。
static int binarySearch(double[] a, int fromIndex, int toIndex, double key) 使用二分搜索算法在指定的雙精度數(shù)組范圍內(nèi)搜索指定值。
static int binarySearch(float[] a, float key) 使用二進(jìn)制搜索算法在指定的浮點數(shù)數(shù)組中搜索指定的值。
static int binarySearch(float[] a, int fromIndex, int toIndex, float key) 使用二分搜索算法在指定浮點數(shù)數(shù)組的范圍內(nèi)搜索指定值。
static int binarySearch(int[] a, int key) 使用二進(jìn)制搜索算法在指定的整數(shù)數(shù)組中搜索指定的值。
static int binarySearch(int[] a, int fromIndex, int toIndex, int key) 使用二進(jìn)制搜索算法在指定整數(shù)數(shù)組的范圍內(nèi)搜索指定值。
static int binarySearch(long[] a, int fromIndex, int toIndex, long key) 使用二進(jìn)制搜索算法在指定的 long 數(shù)組的范圍內(nèi)搜索指定值。
static int binarySearch(long[] a, long key) 使用二進(jìn)制搜索算法在指定的 long 數(shù)組中搜索指定的值。
static int binarySearch(short[] a, int fromIndex, int toIndex, short key) 使用二分搜索算法在指定的 short 數(shù)組的范圍內(nèi)搜索指定的值。
static int binarySearch(short[] a, short key) 使用二分搜索算法在指定的 short 數(shù)組中搜索指定的值。
static int binarySearch(Object[] a, int fromIndex, int toIndex, Object key) 使用二分搜索算法在指定數(shù)組的范圍內(nèi)搜索指定對象。
static int binarySearch(Object[] a, Object key) 使用二分搜索算法在指定數(shù)組中搜索指定對象。
static <T> int binarySearch(T[] a, int fromIndex, int toIndex, T key, Comparator<? super T> c) 使用二分搜索算法在指定數(shù)組的范圍內(nèi)搜索指定對象。
static <T> int binarySearch(T[] a, T key, Comparator<? super T> c) 使用二分搜索算法在指定數(shù)組中搜索指定對象。
static boolean[] copyOf(boolean[] original, int newLength) 復(fù)制指定的數(shù)組,用 false 截斷或填充(如果需要),使副本具有指定的長度。
static byte[] copyOf(byte[] original, int newLength) 復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。
static char[] copyOf(char[] original, int newLength) 復(fù)制指定的數(shù)組,用空字符截斷或填充(如有必要),使副本具有指定的長度。
static double[] copyOf(double[] original, int newLength) 復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。
static float[] copyOf(float[] original, int newLength) 復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。
static int[] copyOf(int[] original, int newLength) 復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。
static long[] copyOf(long[] original, int newLength) 復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。
static short[] copyOf(short[] original, int newLength) 復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。
static <T> T[] copyOf(T[] original, int newLength) 復(fù)制指定的數(shù)組,截斷或填充空值(如有必要),使副本具有指定的長度。
static <T,U> T[] copyOf(U[] original, int newLength, Class<? extends T[]> newType) 復(fù)制指定的數(shù)組,截斷或填充空值(如有必要),使副本具有指定的長度。
static boolean[] copyOfRange(boolean[] original, int from, int to) 將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。
static byte[] copyOfRange(byte[] original, int from, int to) 將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。
static char[] copyOfRange(char[] original, int from, int to) 將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。
static double[] copyOfRange(double[] original, int from, int to) 將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。
static float[] copyOfRange(float[] original, int from, int to) 將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。
static int[] copyOfRange(int[] original, int from, int to) 將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。
static long[] copyOfRange(long[] original, int from, int to) 將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。
static short[] copyOfRange(short[] original, int from, int to) 將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。
static <T> T[] copyOfRange(T[] original, int from, int to) 將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。
static <T,U> T[] copyOfRange(U[] original, int from, int to, Class<? extends T[]> newType) 將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。
static boolean deepEquals(Object[] a1, Object[] a2) 如果兩個指定的數(shù)組彼此深度相等,則返回 true。
static int deepHashCode(Object[] a) 根據(jù)指定數(shù)組的“深層內(nèi)容”返回哈希碼。
static String deepToString(Object[] a) 返回指定數(shù)組的“深層內(nèi)容”的字符串表示形式。
static boolean equals(boolean[] a, boolean[] a2) 如果兩個指定的布爾值數(shù)組彼此相等,則返回 true。
static boolean equals(byte[] a, byte[] a2) 如果兩個指定的字節(jié)數(shù)組彼此相等,則返回 true。
static boolean equals(char[] a, char[] a2) 如果兩個指定的字符數(shù)組彼此相等,則返回 true。
static boolean equals(double[] a, double[] a2) 如果兩個指定的雙精度數(shù)組彼此相等,則返回 true。
static boolean equals(float[] a, float[] a2) 如果兩個指定的浮點數(shù)組彼此相等,則返回 true。
static boolean equals(int[] a, int[] a2) 如果兩個指定的 int 數(shù)組彼此相等,則返回 true。
static boolean equals(long[] a, long[] a2) 如果兩個指定的 long 數(shù)組彼此相等,則返回 true。
static boolean equals(short[] a, short[] a2) 如果兩個指定的 short 數(shù)組彼此相等,則返回 true。
static boolean equals(Object[] a, Object[] a2) 如果兩個指定的 Objects 數(shù)組彼此相等,則返回 true。
static void fill(boolean[] a, boolean val) 將指定的布爾值分配給指定的布爾數(shù)組的每個元素。
static void fill(boolean[] a, int fromIndex, int toIndex, boolean val) 將指定的布爾值分配給指定布爾數(shù)組的指定范圍的每個元素。
static void fill(byte[] a, byte val) 將指定的字節(jié)值分配給指定字節(jié)數(shù)組的每個元素。
static void fill(byte[] a, int fromIndex, int toIndex, byte val) 將指定的字節(jié)值分配給指定字節(jié)數(shù)組的指定范圍的每個元素。
static void fill(char[] a, char val) 將指定的 char 值分配給指定的 char 數(shù)組的每個元素。
static void fill(char[] a, int fromIndex, int toIndex, char val) 將指定的 char 值分配給指定字符數(shù)組的指定范圍的每個元素。
static void fill(double[] a, double val) 將指定的 double 值分配給指定的 double 數(shù)組的每個元素。
static void fill(double[] a, int fromIndex, int toIndex, double val) 將指定的 double 值分配給指定的 double 數(shù)組的指定范圍內(nèi)的每個元素。
static void fill(float[] a, float val) 將指定的浮點值分配給指定浮點數(shù)組的每個元素。
static void fill(float[] a, int fromIndex, int toIndex, float val) 將指定的浮點值分配給指定浮點數(shù)組的指定范圍的每個元素。
static void fill(int[] a, int val) 將指定的 int 值分配給指定的 int 數(shù)組的每個元素。
static void fill(int[] a, int fromIndex, int toIndex, int val) 將指定的 int 值分配給指定 int 數(shù)組的指定范圍的每個元素。
static void fill(long[] a, int fromIndex, int toIndex, long val) 將指定的 long 值分配給指定 long 數(shù)組的指定范圍的每個元素。
static void fill(long[] a, long val) 將指定的 long 值分配給指定的 long 數(shù)組的每個元素。
static void fill(short[] a, int fromIndex, int toIndex, short val) 將指定的 short 值分配給指定的 short 數(shù)組的指定范圍的每個元素。
static void fill(short[] a, short val) 將指定的 short 值分配給指定的 short 數(shù)組的每個元素。
static void fill(Object[] a, int fromIndex, int toIndex, Object val) 將指定的 Object 引用分配給指定的 Objects 數(shù)組的指定范圍內(nèi)的每個元素。
static void fill(Object[] a, Object val) 將指定的 Object 引用分配給指定的 Objects 數(shù)組的每個元素。
static int hashCode(boolean[] a) 根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。
static int hashCode(byte[] a) 根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。
static int hashCode(char[] a) 根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。
static int hashCode(double[] a) 根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。
static int hashCode(float[] a) 根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。
static int hashCode(int[] a) 根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。
static int hashCode(long[] a) 根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。
static int hashCode(short[] a) 根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。
static int hashCode(Object[] a) 根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。
static void parallelPrefix(double[] array, int fromIndex, int toIndex, DoubleBinaryOperator op) 對數(shù)組的給定子范圍執(zhí)行 [parallelPrefix(double],java.util.function.DoubleBinaryOperator)。
static void parallelPrefix(double[] array, DoubleBinaryOperator op) 使用提供的函數(shù)并行累積給定數(shù)組的每個元素。
static void parallelPrefix(int[] array, int fromIndex, int toIndex, IntBinaryOperator op) 對數(shù)組的給定子范圍執(zhí)行 [parallelPrefix(int],java.util.function.IntBinaryOperator)。
static void parallelPrefix(int[] array, IntBinaryOperator op) 使用提供的函數(shù)并行累積給定數(shù)組的每個元素。
static void parallelPrefix(long[] array, int fromIndex, int toIndex, LongBinaryOperator op) 對數(shù)組的給定子范圍執(zhí)行 [parallelPrefix(long],java.util.function.LongBinaryOperator)。
static void parallelPrefix(long[] array, LongBinaryOperator op) 使用提供的函數(shù)并行累積給定數(shù)組的每個元素。
static <T> void parallelPrefix(T[] array, int fromIndex, int toIndex, BinaryOperator<T> op) 對數(shù)組的給定子范圍執(zhí)行 [parallelPrefix(java.lang.Object],java.util.function.BinaryOperator)。
static <T> void parallelPrefix(T[] array, BinaryOperator<T> op) 使用提供的函數(shù)并行累積給定數(shù)組的每個元素。
static void parallelSetAll(double[] array, IntToDoubleFunction generator) 使用提供的生成器函數(shù)并行設(shè)置指定數(shù)組的所有元素來計算每個元素。
static void parallelSetAll(int[] array, IntUnaryOperator generator) 使用提供的生成器函數(shù)并行設(shè)置指定數(shù)組的所有元素來計算每個元素。
static void parallelSetAll(long[] array, IntToLongFunction generator) 使用提供的生成器函數(shù)并行設(shè)置指定數(shù)組的所有元素來計算每個元素。
static <T> void parallelSetAll(T[] array, IntFunction<? extends T> generator) 使用提供的生成器函數(shù)并行設(shè)置指定數(shù)組的所有元素來計算每個元素。
static void parallelSort(byte[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void parallelSort(byte[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按數(shù)字升序排序。
static void parallelSort(char[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void parallelSort(char[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按數(shù)字升序排序。
static void parallelSort(double[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void parallelSort(double[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按數(shù)字升序排序。
static void parallelSort(float[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void parallelSort(float[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按數(shù)字升序排序。
static void parallelSort(int[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void parallelSort(int[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按數(shù)字升序排序。
static void parallelSort(long[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void parallelSort(long[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按數(shù)字升序排序。
static void parallelSort(short[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void parallelSort(short[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按數(shù)字升序排序。
static <T extends Comparable<? super T>>void parallelSort(T[] a) 根據(jù)其元素的 Comparable 對指定的對象數(shù)組進(jìn)行升序排序。
static <T extends Comparable<? super T>>void parallelSort(T[] a, int fromIndex, int toIndex) 根據(jù)其元素的 Comparable 對指定對象數(shù)組的指定范圍進(jìn)行升序排序。
static <T> void parallelSort(T[] a, int fromIndex, int toIndex, Comparator<? super T> cmp) 根據(jù)指定比較器的順序?qū)χ付▽ο髷?shù)組的指定范圍進(jìn)行排序。
static <T> void parallelSort(T[] a, Comparator<? super T> cmp) 根據(jù)指定比較器產(chǎn)生的順序?qū)χ付ǖ膶ο髷?shù)組進(jìn)行排序。
static void setAll(double[] array, IntToDoubleFunction generator) 設(shè)置指定數(shù)組的所有元素,使用提供的生成器函數(shù)計算每個元素。
static void setAll(int[] array, IntUnaryOperator generator) 設(shè)置指定數(shù)組的所有元素,使用提供的生成器函數(shù)計算每個元素。
static void setAll(long[] array, IntToLongFunction generator) 設(shè)置指定數(shù)組的所有元素,使用提供的生成器函數(shù)計算每個元素。
static <T> void setAll(T[] array, IntFunction<? extends T> generator) 設(shè)置指定數(shù)組的所有元素,使用提供的生成器函數(shù)計算每個元素。
static void sort(byte[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void sort(byte[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按升序排序。
static void sort(char[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void sort(char[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按升序排序。
static void sort(double[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void sort(double[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按升序排序。
static void sort(float[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void sort(float[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按升序排序。
static void sort(int[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void sort(int[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按升序排序。
static void sort(long[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void sort(long[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按升序排序。
static void sort(short[] a) 將指定的數(shù)組按數(shù)字升序排序。
static void sort(short[] a, int fromIndex, int toIndex) 將數(shù)組的指定范圍按升序排序。
static void sort(Object[] a) 根據(jù)其元素的 Comparable 對指定的對象數(shù)組進(jìn)行升序排序。
static void sort(Object[] a, int fromIndex, int toIndex) 根據(jù)其元素的 Comparable 對指定對象數(shù)組的指定范圍進(jìn)行升序排序。
static <T> void sort(T[] a, int fromIndex, int toIndex, Comparator<? super T> c) 根據(jù)指定比較器的順序?qū)χ付▽ο髷?shù)組的指定范圍進(jìn)行排序。
static <T> void sort(T[] a, Comparator<? super T> c) 根據(jù)指定比較器產(chǎn)生的順序?qū)χ付ǖ膶ο髷?shù)組進(jìn)行排序。
static Spliterator.OfDouble spliterator(double[] array) 返回一個 Spliterator.OfDouble 覆蓋所有指定的數(shù)組。
static Spliterator.OfDouble spliterator(double[] array, int startInclusive, int endExclusive) 返回一個 Spliterator.OfDouble 覆蓋指定數(shù)組的指定范圍。
static Spliterator.OfInt spliterator(int[] array) 返回一個 Spliterator.OfInt 覆蓋所有指定的數(shù)組。
static Spliterator.OfInt spliterator(int[] array, int startInclusive, int endExclusive) 返回一個 Spliterator.OfInt 覆蓋指定數(shù)組的指定范圍。
static Spliterator.OfLong spliterator(long[] array) 返回一個 Spliterator.OfLong 覆蓋所有指定的數(shù)組。
static Spliterator.OfLong spliterator(long[] array, int startInclusive, int endExclusive) 返回一個 Spliterator.OfLong 覆蓋指定數(shù)組的指定范圍。
static <T> Spliterator<T> spliterator(T[] array) 返回一個涵蓋所有指定數(shù)組的 Spliterator。
static <T> Spliterator<T> spliterator(T[] array, int startInclusive, int endExclusive) 返回一個Spliterator,覆蓋指定數(shù)組的指定范圍。
static DoubleStream stream(double[] array) 返回以指定數(shù)組為源的順序 DoubleStream。
static DoubleStream stream(double[] array, int startInclusive, int endExclusive) 返回以指定數(shù)組的指定范圍作為源的順序 DoubleStream。
static IntStream stream(int[] array) 返回以指定數(shù)組作為源的順序 IntStream。
static IntStream stream(int[] array, int startInclusive, int endExclusive) 返回以指定數(shù)組的指定范圍作為源的順序 IntStream。
static LongStream stream(long[] array) 返回以指定數(shù)組為源的順序 LongStream。
static LongStream stream(long[] array, int startInclusive, int endExclusive) 返回以指定數(shù)組的指定范圍作為源的順序 LongStream。
static <T> Stream<T> stream(T[] array) 返回以指定數(shù)組為源的順序流。
static <T> Stream<T> stream(T[] array, int startInclusive, int endExclusive) 返回以指定數(shù)組的指定范圍作為源的順序流。
static String toString(boolean[] a) 返回指定數(shù)組內(nèi)容的字符串表示形式。
static String toString(byte[] a) 返回指定數(shù)組內(nèi)容的字符串表示形式。
static String toString(char[] a) 返回指定數(shù)組內(nèi)容的字符串表示形式。
static String toString(double[] a) 返回指定數(shù)組內(nèi)容的字符串表示形式。
static String toString(float[] a) 返回指定數(shù)組內(nèi)容的字符串表示形式。
static String toString(int[] a) 返回指定數(shù)組內(nèi)容的字符串表示形式。
static String toString(long[] a) 返回指定數(shù)組內(nèi)容的字符串表示形式。
static String toString(short[] a) 返回指定數(shù)組內(nèi)容的字符串表示形式。
static String toString(Object[] a) 返回指定數(shù)組內(nèi)容的字符串表示形式。
從類 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法詳情

sort

public static void sort(int[] a)

將指定的數(shù)組按數(shù)字升序排序。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

sort

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

將數(shù)組的指定范圍按升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

sort

public static void sort(long[] a)

將指定的數(shù)組按數(shù)字升序排序。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

sort

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

將數(shù)組的指定范圍按升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

sort

public static void sort(short[] a)

將指定的數(shù)組按數(shù)字升序排序。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

sort

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

將數(shù)組的指定范圍按升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

sort

public static void sort(char[] a)

將指定的數(shù)組按數(shù)字升序排序。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

sort

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

將數(shù)組的指定范圍按升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

sort

public static void sort(byte[] a)

將指定的數(shù)組按數(shù)字升序排序。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

sort

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

將數(shù)組的指定范圍按升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

sort

public static void sort(float[] a)

將指定的數(shù)組按數(shù)字升序排序。

< 關(guān)系不提供所有浮點值的總順序:-0.0f == 0.0f 為真,并且 Float.NaN 值比較不小于、大于或等于任何值,甚至它本身。 此方法使用 Float#compareTo 方法施加的總順序:-0.0f 被視為小于值 0.0f,F(xiàn)loat.NaN 被視為大于任何其他值,并且所有 Float.NaN 值被視為相等。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

sort

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

將數(shù)組的指定范圍按升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

< 關(guān)系不提供所有浮點值的總順序:-0.0f == 0.0f 為真,并且 Float.NaN 值比較不小于、大于或等于任何值,甚至它本身。 此方法使用 Float#compareTo 方法施加的總順序:-0.0f 被視為小于值 0.0f,F(xiàn)loat.NaN 被視為大于任何其他值,并且所有 Float.NaN 值被視為相等。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

sort

public static void sort(double[] a)

將指定的數(shù)組按數(shù)字升序排序。

< 關(guān)系不提供所有雙精度值的總順序:-0.0d == 0.0d 為真,并且 Double.NaN 值比較不小于、大于或等于任何值,甚至它本身。 此方法使用 Double#compareTo 方法施加的總順序:-0.0d 被視為小于值 0.0d,Double.NaN 被視為大于任何其他值,并且所有 Double.NaN 值被視為相等。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

sort

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

將數(shù)組的指定范圍按升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

< 關(guān)系不提供所有雙精度值的總順序:-0.0d == 0.0d 為真,并且 Double.NaN 值比較不小于、大于或等于任何值,甚至它本身。 此方法使用 Double#compareTo 方法施加的總順序:-0.0d 被視為小于值 0.0d,Double.NaN 被視為大于任何其他值,并且所有 Double.NaN 值被視為相等。

實施說明:排序算法是 Vladimir Yaroslavskiy、Jon Bentley 和 Joshua Bloch 的 Dual-Pivot Quicksort。 該算法在許多數(shù)據(jù)集上提供 O(n log(n)) 性能,導(dǎo)致其他快速排序降低到二次性能,并且通常比傳統(tǒng)的(單軸)快速排序?qū)崿F(xiàn)更快。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

parallelSort

public static void parallelSort(byte[] a)

將指定的數(shù)組按數(shù)字升序排序。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

parallelSort

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

將數(shù)組的指定范圍按數(shù)字升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

parallelSort

public static void parallelSort(char[] a)

將指定的數(shù)組按數(shù)字升序排序。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

parallelSort

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

將數(shù)組的指定范圍按數(shù)字升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

parallelSort

public static void parallelSort(short[] a)

將指定的數(shù)組按數(shù)字升序排序。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

parallelSort

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

將數(shù)組的指定范圍按數(shù)字升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

parallelSort

public static void parallelSort(int[] a)

將指定的數(shù)組按數(shù)字升序排序。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

parallelSort

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

將數(shù)組的指定范圍按數(shù)字升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

parallelSort

public static void parallelSort(long[] a)

將指定的數(shù)組按數(shù)字升序排序。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

parallelSort

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

將數(shù)組的指定范圍按數(shù)字升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

parallelSort

public static void parallelSort(float[] a)

將指定的數(shù)組按數(shù)字升序排序。

< 關(guān)系不提供所有浮點值的總順序:-0.0f == 0.0f 為真,并且 Float.NaN 值比較不小于、大于或等于任何值,甚至它本身。 此方法使用 Float#compareTo 方法施加的總順序:-0.0f 被視為小于值 0.0f,F(xiàn)loat.NaN 被視為大于任何其他值,并且所有 Float.NaN 值被視為相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

parallelSort

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

將數(shù)組的指定范圍按數(shù)字升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

< 關(guān)系不提供所有浮點值的總順序:-0.0f == 0.0f 為真,并且 Float.NaN 值比較不小于、大于或等于任何值,甚至它本身。 此方法使用 Float#compareTo 方法施加的總順序:-0.0f 被視為小于值 0.0f,F(xiàn)loat.NaN 被視為大于任何其他值,并且所有 Float.NaN 值被視為相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

parallelSort

public static void parallelSort(double[] a)

將指定的數(shù)組按數(shù)字升序排序。

< 關(guān)系不提供所有雙精度值的總順序:-0.0d == 0.0d 為真,并且 Double.NaN 值比較不小于、大于或等于任何值,甚至它本身。 此方法使用 Double#compareTo 方法施加的總順序:-0.0d 被視為小于值 0.0d,Double.NaN 被視為大于任何其他值,并且所有 Double.NaN 值被視為相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

parallelSort

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

將數(shù)組的指定范圍按數(shù)字升序排序。 要排序的范圍從索引 fromIndex(含)延伸到索引 toIndex(不含)。 如果 fromIndex == toIndex,則要排序的范圍為空。

< 關(guān)系不提供所有雙精度值的總順序:-0.0d == 0.0d 為真,并且 Double.NaN 值比較不小于、大于或等于任何值,甚至它本身。 此方法使用 Double#compareTo 方法施加的總順序:-0.0d 被視為小于值 0.0d,Double.NaN 被視為大于任何其他值,并且所有 Double.NaN 值被視為相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素的索引,排他性

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

parallelSort

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

根據(jù)其元素的 Comparable 對指定的對象數(shù)組進(jìn)行升序排序。 數(shù)組中的所有元素都必須實現(xiàn) Comparable 接口。 此外,數(shù)組中的所有元素必須相互可比較(即,e1.compareTo(e2) 不得為數(shù)組中的任何元素 e1 和 e2 拋出 ClassCastException)。

這種排序保證是穩(wěn)定的:相同的元素不會因為排序而重新排序。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 要排序的對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

Throws:

Throw名稱 Throw描述
ClassCastException 如果數(shù)組包含不可相互比較的元素(例如,字符串和整數(shù))
IllegalArgumentException (可選)如果發(fā)現(xiàn)數(shù)組元素的自然順序違反了 Comparable 合約

parallelSort

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

根據(jù)其元素的 Comparable 對指定對象數(shù)組的指定范圍進(jìn)行升序排序。 要排序的范圍從 index fromIndex(包括)擴(kuò)展到 index toIndex(不包括)。 (如果fromIndex==toIndex,則要排序的范圍為空。)該范圍內(nèi)的所有元素都必須實現(xiàn)Comparable接口。 此外,此范圍內(nèi)的所有元素必須相互可比較(即,e1.compareTo(e2) 不得為數(shù)組中的任何元素 e1 和 e2 拋出 ClassCastException)。

這種排序保證是穩(wěn)定的:相同的元素不會因為排序而重新排序。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 要排序的對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素(不包括)的索引

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex 或(可選)如果發(fā)現(xiàn)數(shù)組元素的自然順序違反了 Comparable 約定
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length
ClassCastException 如果數(shù)組包含不可相互比較的元素(例如,字符串和整數(shù))。

parallelSort

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

根據(jù)指定比較器產(chǎn)生的順序?qū)χ付ǖ膶ο髷?shù)組進(jìn)行排序。 數(shù)組中的所有元素必須通過指定的比較器相互比較(即,c.compare(e1, e2) 不得為數(shù)組中的任何元素 e1 和 e2 拋出 ClassCastException)。

這種排序保證是穩(wěn)定的:相同的元素不會因為排序而重新排序。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 要排序的對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
cmp 比較器來確定數(shù)組的順序。 空值表示應(yīng)該使用元素的 Comparable。

Throws:

Throw名稱 Throw描述
ClassCastException 如果數(shù)組包含使用指定比較器不能相互比較的元素
IllegalArgumentException (可選)如果發(fā)現(xiàn)比較器違反了比較器合同

parallelSort

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

根據(jù)指定比較器的順序?qū)χ付▽ο髷?shù)組的指定范圍進(jìn)行排序。 要排序的范圍從 index fromIndex(包括)擴(kuò)展到 index toIndex(不包括)。 (如果 fromIndex==toIndex,則要排序的范圍為空。)范圍內(nèi)的所有元素必須通過指定的比較器相互比較(即 c.compare(e1, e2) 不得為任何元素 e1 拋出 ClassCastException 和 e2 在范圍內(nèi))。

這種排序保證是穩(wěn)定的:相同的元素不會因為排序而重新排序。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 要排序的對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素(不包括)的索引
cmp 比較器來確定數(shù)組的順序。 空值表示應(yīng)該使用元素的 Comparable。

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex 或(可選)如果發(fā)現(xiàn)數(shù)組元素的自然順序違反了 Comparable 約定
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length
ClassCastException 如果數(shù)組包含不可相互比較的元素(例如,字符串和整數(shù))。

sort

public static void sort(Object[] a)

根據(jù)其元素的 Comparable 對指定的對象數(shù)組進(jìn)行升序排序。數(shù)組中的所有元素都必須實現(xiàn) Comparable 接口。此外,數(shù)組中的所有元素必須相互可比較(即,e1.compareTo(e2) 不得為數(shù)組中的任何元素 e1 和 e2 拋出 ClassCastException)。

這種排序保證是穩(wěn)定的:相同的元素不會因為排序而重新排序。

實現(xiàn)說明:此實現(xiàn)是一種穩(wěn)定的、自適應(yīng)的、迭代的歸并排序,當(dāng)輸入數(shù)組部分排序時,它需要遠(yuǎn)少于 n 次 lg(n) 的比較,同時在輸入數(shù)組隨機(jī)排序時提供傳統(tǒng)歸并排序的性能。如果輸入數(shù)組接近排序,則實現(xiàn)需要大約 n 次比較。臨時存儲要求從幾乎排序的輸入數(shù)組的小常數(shù)到隨機(jī)排序的輸入數(shù)組的 n/2 對象引用不等。

該實現(xiàn)在其輸入數(shù)組中同等地利用升序和降序,并且可以在同一輸入數(shù)組的不同部分利用升序和降序。它非常適合合并兩個或多個排序數(shù)組:只需連接數(shù)組并對結(jié)果數(shù)組進(jìn)行排序。

該實現(xiàn)改編自 Tim Peters 的 Python 列表排序 (TimSort)。它使用了 Peter McIlroy 在 1993 年 1 月的第四屆 ACM-SIAM 離散算法年度研討會論文集上的“樂觀排序和信息理論復(fù)雜性”中的技術(shù)。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組

Throws:

Throw名稱 Throw描述
ClassCastException 如果數(shù)組包含不可相互比較的元素(例如,字符串和整數(shù))
IllegalArgumentException (可選)如果發(fā)現(xiàn)數(shù)組元素的自然順序違反了 Comparable 合約

sort

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

根據(jù)其元素的 Comparable 對指定對象數(shù)組的指定范圍進(jìn)行升序排序。要排序的范圍從 index fromIndex(包括)擴(kuò)展到 index toIndex(不包括)。 (如果fromIndex==toIndex,則要排序的范圍為空。)該范圍內(nèi)的所有元素都必須實現(xiàn)Comparable接口。此外,此范圍內(nèi)的所有元素必須相互可比較(即,e1.compareTo(e2) 不得為數(shù)組中的任何元素 e1 和 e2 拋出 ClassCastException)。

這種排序保證是穩(wěn)定的:相同的元素不會因為排序而重新排序。

實現(xiàn)說明:此實現(xiàn)是一種穩(wěn)定的、自適應(yīng)的、迭代的歸并排序,當(dāng)輸入數(shù)組部分排序時,它需要遠(yuǎn)少于 n 次 lg(n) 的比較,同時在輸入數(shù)組隨機(jī)排序時提供傳統(tǒng)歸并排序的性能。如果輸入數(shù)組接近排序,則實現(xiàn)需要大約 n 次比較。臨時存儲要求從幾乎排序的輸入數(shù)組的小常數(shù)到隨機(jī)排序的輸入數(shù)組的 n/2 對象引用不等。

該實現(xiàn)在其輸入數(shù)組中同等地利用升序和降序,并且可以在同一輸入數(shù)組的不同部分利用升序和降序。它非常適合合并兩個或多個排序數(shù)組:只需連接數(shù)組并對結(jié)果數(shù)組進(jìn)行排序。

該實現(xiàn)改編自 Tim Peters 的 Python 列表排序 (TimSort)。它使用了 Peter McIlroy 在 1993 年 1 月的第四屆 ACM-SIAM 離散算法年度研討會論文集上的“樂觀排序和信息理論復(fù)雜性”中的技術(shù)。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素(不包括)的索引

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex 或(可選)如果發(fā)現(xiàn)數(shù)組元素的自然順序違反了 Comparable 約定
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length
ClassCastException 如果數(shù)組包含不可相互比較的元素(例如,字符串和整數(shù))。

sort

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

根據(jù)指定比較器產(chǎn)生的順序?qū)χ付ǖ膶ο髷?shù)組進(jìn)行排序。數(shù)組中的所有元素必須通過指定的比較器相互比較(即,c.compare(e1, e2) 不得為數(shù)組中的任何元素 e1 和 e2 拋出 ClassCastException)。

這種排序保證是穩(wěn)定的:相同的元素不會因為排序而重新排序。

實現(xiàn)說明:此實現(xiàn)是一種穩(wěn)定的、自適應(yīng)的、迭代的歸并排序,當(dāng)輸入數(shù)組部分排序時,它需要遠(yuǎn)少于 n 次 lg(n) 的比較,同時在輸入數(shù)組隨機(jī)排序時提供傳統(tǒng)歸并排序的性能。如果輸入數(shù)組接近排序,則實現(xiàn)需要大約 n 次比較。臨時存儲要求從幾乎排序的輸入數(shù)組的小常數(shù)到隨機(jī)排序的輸入數(shù)組的 n/2 對象引用不等。

該實現(xiàn)在其輸入數(shù)組中同等地利用升序和降序,并且可以在同一輸入數(shù)組的不同部分利用升序和降序。它非常適合合并兩個或多個排序數(shù)組:只需連接數(shù)組并對結(jié)果數(shù)組進(jìn)行排序。

該實現(xiàn)改編自 Tim Peters 的 Python 列表排序 (TimSort)。它使用了 Peter McIlroy 在 1993 年 1 月的第四屆 ACM-SIAM 離散算法年度研討會論文集上的“樂觀排序和信息理論復(fù)雜性”中的技術(shù)。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 要排序的對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
c 比較器來確定數(shù)組的順序。 空值表示應(yīng)該使用元素的 Comparable。

Throws:

Throw名稱 Throw描述
ClassCastException 如果數(shù)組包含使用指定比較器不能相互比較的元素
IllegalArgumentException (可選)如果發(fā)現(xiàn)比較器違反了比較器合同

sort

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

根據(jù)指定比較器的順序?qū)χ付▽ο髷?shù)組的指定范圍進(jìn)行排序。要排序的范圍從 index fromIndex(包括)擴(kuò)展到 index toIndex(不包括)。 (如果 fromIndex==toIndex,則要排序的范圍為空。)范圍內(nèi)的所有元素必須通過指定的比較器相互比較(即 c.compare(e1, e2) 不得為任何元素 e1 拋出 ClassCastException和 e2 在范圍內(nèi))。

這種排序保證是穩(wěn)定的:相同的元素不會因為排序而重新排序。

實現(xiàn)說明:此實現(xiàn)是一種穩(wěn)定的、自適應(yīng)的、迭代的歸并排序,當(dāng)輸入數(shù)組部分排序時,它需要遠(yuǎn)少于 n 次 lg(n) 的比較,同時在輸入數(shù)組隨機(jī)排序時提供傳統(tǒng)歸并排序的性能。如果輸入數(shù)組接近排序,則實現(xiàn)需要大約 n 次比較。臨時存儲要求從幾乎排序的輸入數(shù)組的小常數(shù)到隨機(jī)排序的輸入數(shù)組的 n/2 對象引用不等。

該實現(xiàn)在其輸入數(shù)組中同等地利用升序和降序,并且可以在同一輸入數(shù)組的不同部分利用升序和降序。它非常適合合并兩個或多個排序數(shù)組:只需連接數(shù)組并對結(jié)果數(shù)組進(jìn)行排序。

該實現(xiàn)改編自 Tim Peters 的 Python 列表排序 (TimSort)。它使用了 Peter McIlroy 在 1993 年 1 月的第四屆 ACM-SIAM 離散算法年度研討會論文集上的“樂觀排序和信息理論復(fù)雜性”中的技術(shù)。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 要排序的對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要排序的數(shù)組
fromIndex 要排序的第一個元素(包括)的索引
toIndex 要排序的最后一個元素(不包括)的索引
c 比較器來確定數(shù)組的順序。 空值表示應(yīng)該使用元素的 Comparable。

Throws:

Throw名稱 Throw描述
ClassCastException 如果數(shù)組包含使用指定比較器不能相互比較的元素。
IllegalArgumentException 如果 fromIndex > toIndex 或(可選)如果發(fā)現(xiàn)比較器違反了比較器合約
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

parallelPrefix

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

使用提供的函數(shù)并行累積給定數(shù)組的每個元素。 例如,如果數(shù)組最初保存 [2, 1, 0, 3] 并且操作執(zhí)行加法,則返回時數(shù)組保存 [2, 3, 3, 6]。 對于大型數(shù)組,并行前綴計算通常比順序循環(huán)更有效。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組中對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,通過此方法就地修改
op 執(zhí)行累積的無副作用的關(guān)聯(lián)函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果指定的數(shù)組或函數(shù)為空

parallelPrefix

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

對數(shù)組的給定子范圍執(zhí)行 [parallelPrefix(java.lang.Object],java.util.function.BinaryOperator)。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組中對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組
fromIndex 第一個元素的索引,包括
toIndex 最后一個元素的索引,不包含
op 執(zhí)行累積的無副作用的關(guān)聯(lián)函數(shù)

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > array.length
NullPointerException 如果指定的數(shù)組或函數(shù)為空

parallelPrefix

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

使用提供的函數(shù)并行累積給定數(shù)組的每個元素。 例如,如果數(shù)組最初保存 [2, 1, 0, 3] 并且操作執(zhí)行加法,則返回時數(shù)組保存 [2, 3, 3, 6]。 對于大型數(shù)組,并行前綴計算通常比順序循環(huán)更有效。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,通過此方法就地修改
op 執(zhí)行累積的無副作用的關(guān)聯(lián)函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果指定的數(shù)組或函數(shù)為空

parallelPrefix

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

對數(shù)組的給定子范圍執(zhí)行 [parallelPrefix(long],java.util.function.LongBinaryOperator)。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組
fromIndex 第一個元素的索引,包括
toIndex 最后一個元素的索引,不包含
op 執(zhí)行累積的無副作用的關(guān)聯(lián)函數(shù)

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > array.length
NullPointerException 如果指定的數(shù)組或函數(shù)為空

parallelPrefix

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

使用提供的函數(shù)并行累積給定數(shù)組的每個元素。 例如,如果數(shù)組最初保存 [2.0, 1.0, 0.0, 3.0] 并且操作執(zhí)行加法,則返回時數(shù)組保存 [2.0, 3.0, 3.0, 6.0]。 對于大型數(shù)組,并行前綴計算通常比順序循環(huán)更有效。

因為浮點運(yùn)算可能不是嚴(yán)格關(guān)聯(lián)的,所以返回的結(jié)果可能與按順序執(zhí)行運(yùn)算時獲得的值不同。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,通過此方法就地修改
op 執(zhí)行累積的無副作用函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果指定的數(shù)組或函數(shù)為空

parallelPrefix

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

對數(shù)組的給定子范圍執(zhí)行 [parallelPrefix(double],java.util.function.DoubleBinaryOperator)。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組
fromIndex 第一個元素的索引,包括
toIndex 最后一個元素的索引,不包含
op 執(zhí)行累積的無副作用的關(guān)聯(lián)函數(shù)

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > array.length
NullPointerException 如果指定的數(shù)組或函數(shù)為空

parallelPrefix

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

使用提供的函數(shù)并行累積給定數(shù)組的每個元素。 例如,如果數(shù)組最初保存 [2, 1, 0, 3] 并且操作執(zhí)行加法,則返回時數(shù)組保存 [2, 3, 3, 6]。 對于大型數(shù)組,并行前綴計算通常比順序循環(huán)更有效。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,通過此方法就地修改
op 執(zhí)行累積的無副作用的關(guān)聯(lián)函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果指定的數(shù)組或函數(shù)為空

parallelPrefix

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

對數(shù)組的給定子范圍執(zhí)行 [parallelPrefix(int],java.util.function.IntBinaryOperator)。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組
fromIndex 第一個元素的索引,包括
toIndex 最后一個元素的索引,不包含
op 執(zhí)行累積的無副作用的關(guān)聯(lián)函數(shù)

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > array.length
NullPointerException 如果指定的數(shù)組或函數(shù)為空

binarySearch

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

使用二進(jìn)制搜索算法在指定的 long 數(shù)組中搜索指定的值。 在進(jìn)行此調(diào)用之前,必須對數(shù)組進(jìn)行排序(如通過 [sort(long]) 方法)。 如果未排序,則結(jié)果未定義。 如果數(shù)組包含多個具有指定值的元素,則無法保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為將鍵插入數(shù)組的點:第一個元素的索引大于鍵,或者如果數(shù)組中的所有元素都小于指定的鍵,則為 a.length。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

binarySearch

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

使用二進(jìn)制搜索算法在指定的 long 數(shù)組的范圍內(nèi)搜索指定值。 在進(jìn)行此調(diào)用之前,必須對范圍進(jìn)行排序(如通過 [sort(long],int,int) 方法)。 如果未排序,則結(jié)果未定義。 如果范圍包含多個具有指定值的元素,則無法保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
fromIndex 要搜索的第一個元素(包括)的索引
toIndex 要搜索的最后一個元素(不包括)的索引
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在指定范圍內(nèi)的數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為鍵將插入數(shù)組的點:范圍中大于鍵的第一個元素的索引,如果范圍內(nèi)的所有元素都小于指定的鍵,則為 toIndex。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

binarySearch

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

使用二進(jìn)制搜索算法在指定的整數(shù)數(shù)組中搜索指定的值。 在進(jìn)行此調(diào)用之前,必須對數(shù)組進(jìn)行排序(如通過 [sort(int]) 方法)。 如果未排序,則結(jié)果未定義。 如果數(shù)組包含多個具有指定值的元素,則無法保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為將鍵插入數(shù)組的點:第一個元素的索引大于鍵,或者如果數(shù)組中的所有元素都小于指定的鍵,則為 a.length。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

binarySearch

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

使用二進(jìn)制搜索算法在指定整數(shù)數(shù)組的范圍內(nèi)搜索指定值。 在進(jìn)行此調(diào)用之前,必須對范圍進(jìn)行排序(如通過 [sort(int],int,int) 方法)。 如果未排序,則結(jié)果未定義。 如果范圍包含多個具有指定值的元素,則無法保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
fromIndex 要搜索的第一個元素(包括)的索引
toIndex 要搜索的最后一個元素(不包括)的索引
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在指定范圍內(nèi)的數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為鍵將插入數(shù)組的點:范圍中大于鍵的第一個元素的索引,如果范圍內(nèi)的所有元素都小于指定的鍵,則為 toIndex。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

binarySearch

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

使用二分搜索算法在指定的 short 數(shù)組中搜索指定的值。 在進(jìn)行此調(diào)用之前,必須對數(shù)組進(jìn)行排序(如通過 [sort(short]) 方法)。 如果未排序,則結(jié)果未定義。 如果數(shù)組包含多個具有指定值的元素,則無法保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為將鍵插入數(shù)組的點:第一個元素的索引大于鍵,或者如果數(shù)組中的所有元素都小于指定的鍵,則為 a.length。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

binarySearch

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

使用二分搜索算法在指定的 short 數(shù)組的范圍內(nèi)搜索指定的值。 在進(jìn)行此調(diào)用之前,必須對范圍進(jìn)行排序(如通過 [sort(short],int,int) 方法)。 如果未排序,則結(jié)果未定義。 如果范圍包含多個具有指定值的元素,則無法保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
fromIndex 要搜索的第一個元素(包括)的索引
toIndex 要搜索的最后一個元素(不包括)的索引
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在指定范圍內(nèi)的數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為鍵將插入數(shù)組的點:范圍中大于鍵的第一個元素的索引,如果范圍內(nèi)的所有元素都小于指定的鍵,則為 toIndex。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

binarySearch

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

使用二進(jìn)制搜索算法在指定的字符數(shù)組中搜索指定的值。 在進(jìn)行此調(diào)用之前,必須對數(shù)組進(jìn)行排序(如通過 [sort(char]) 方法)。 如果未排序,則結(jié)果未定義。 如果數(shù)組包含多個具有指定值的元素,則無法保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為將鍵插入數(shù)組的點:第一個元素的索引大于鍵,或者如果數(shù)組中的所有元素都小于指定的鍵,則為 a.length。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

binarySearch

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

使用二進(jìn)制搜索算法在指定字符數(shù)組的范圍內(nèi)搜索指定值。 在進(jìn)行此調(diào)用之前,必須對范圍進(jìn)行排序(如通過 [sort(char],int,int) 方法)。 如果未排序,則結(jié)果未定義。 如果范圍包含多個具有指定值的元素,則無法保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
fromIndex 要搜索的第一個元素(包括)的索引
toIndex 要搜索的最后一個元素(不包括)的索引
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在指定范圍內(nèi)的數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為鍵將插入數(shù)組的點:范圍中大于鍵的第一個元素的索引,如果范圍內(nèi)的所有元素都小于指定的鍵,則為 toIndex。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

binarySearch

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

使用二進(jìn)制搜索算法在指定的字節(jié)數(shù)組中搜索指定的值。 在進(jìn)行此調(diào)用之前,必須對數(shù)組進(jìn)行排序(如通過 [sort(byte]) 方法)。 如果未排序,則結(jié)果未定義。 如果數(shù)組包含多個具有指定值的元素,則無法保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為將鍵插入數(shù)組的點:第一個元素的索引大于鍵,或者如果數(shù)組中的所有元素都小于指定的鍵,則為 a.length。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

binarySearch

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

使用二進(jìn)制搜索算法在指定字節(jié)數(shù)組的范圍內(nèi)搜索指定值。 在進(jìn)行此調(diào)用之前,必須對范圍進(jìn)行排序(如通過 [sort(byte],int,int) 方法)。 如果未排序,則結(jié)果未定義。 如果范圍包含多個具有指定值的元素,則無法保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
fromIndex 要搜索的第一個元素(包括)的索引
toIndex 要搜索的最后一個元素(不包括)的索引
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在指定范圍內(nèi)的數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為鍵將插入數(shù)組的點:范圍中大于鍵的第一個元素的索引,如果范圍內(nèi)的所有元素都小于指定的鍵,則為 toIndex。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

binarySearch

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

使用二進(jìn)制搜索算法在指定的雙精度數(shù)組中搜索指定的值。 在進(jìn)行此調(diào)用之前,必須對數(shù)組進(jìn)行排序(如通過 [sort(double]) 方法)。 如果未排序,則結(jié)果未定義。 如果數(shù)組包含多個具有指定值的元素,則無法保證會找到哪一個。 此方法認(rèn)為所有 NaN 值是等價和相等的。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為將鍵插入數(shù)組的點:第一個元素的索引大于鍵,或者如果數(shù)組中的所有元素都小于指定的鍵,則為 a.length。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

binarySearch

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

使用二分搜索算法在指定的雙精度數(shù)組范圍內(nèi)搜索指定值。 在進(jìn)行此調(diào)用之前,必須對范圍進(jìn)行排序(如通過 [sort(double],int,int) 方法)。 如果未排序,則結(jié)果未定義。 如果范圍包含多個具有指定值的元素,則無法保證會找到哪一個。 此方法認(rèn)為所有 NaN 值是等價和相等的。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
fromIndex 要搜索的第一個元素(包括)的索引
toIndex 要搜索的最后一個元素(不包括)的索引
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在指定范圍內(nèi)的數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為鍵將插入數(shù)組的點:范圍中大于鍵的第一個元素的索引,如果范圍內(nèi)的所有元素都小于指定的鍵,則為 toIndex。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

binarySearch

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

使用二進(jìn)制搜索算法在指定的浮點數(shù)數(shù)組中搜索指定的值。 在進(jìn)行此調(diào)用之前,必須對數(shù)組進(jìn)行排序(如通過 [sort(float]) 方法)。 如果未排序,則結(jié)果未定義。 如果數(shù)組包含多個具有指定值的元素,則無法保證會找到哪一個。 此方法認(rèn)為所有 NaN 值是等價和相等的。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為將鍵插入數(shù)組的點:第一個元素的索引大于鍵,或者如果數(shù)組中的所有元素都小于指定的鍵,則為 a.length。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

binarySearch

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

使用二分搜索算法在指定浮點數(shù)數(shù)組的范圍內(nèi)搜索指定值。 在進(jìn)行此調(diào)用之前,必須對范圍進(jìn)行排序(如通過 [sort(float],int,int) 方法)。 如果未排序,則結(jié)果未定義。 如果范圍包含多個具有指定值的元素,則無法保證會找到哪一個。 此方法認(rèn)為所有 NaN 值是等價和相等的。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
fromIndex 要搜索的第一個元素(包括)的索引
toIndex 要搜索的最后一個元素(不包括)的索引
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在指定范圍內(nèi)的數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為鍵將插入數(shù)組的點:范圍中大于鍵的第一個元素的索引,如果范圍內(nèi)的所有元素都小于指定的鍵,則為 toIndex。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

binarySearch

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

使用二分搜索算法在指定數(shù)組中搜索指定對象。 在進(jìn)行此調(diào)用之前,必須根據(jù)其元素的 Comparable 對數(shù)組進(jìn)行升序排序(如通過 [sort(java.lang.Object]) 方法)。 如果未排序,則結(jié)果未定義。 (如果數(shù)組包含不可相互比較的元素(例如,字符串和整數(shù)),則無法根據(jù)其元素的自然順序?qū)ζ溥M(jìn)行排序,因此結(jié)果未定義。)如果數(shù)組包含多個等于指定對象的元素 , 不能保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為將鍵插入數(shù)組的點:第一個元素的索引大于鍵,或者如果數(shù)組中的所有元素都小于指定的鍵,則為 a.length。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
ClassCastException 如果搜索鍵與數(shù)組的元素不可比較。

binarySearch

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

使用二分搜索算法在指定數(shù)組的范圍內(nèi)搜索指定對象。 在進(jìn)行此調(diào)用之前,必須根據(jù)其元素的 Comparable 對范圍進(jìn)行升序排序(如通過 [sort(java.lang.Object],int,int) 方法)。 如果未排序,則結(jié)果未定義。 (如果范圍包含不可相互比較的元素(例如,字符串和整數(shù)),則無法根據(jù)其元素的自然順序?qū)ζ溥M(jìn)行排序,因此結(jié)果未定義。)如果范圍包含多個等于指定對象的元素 , 不能保證會找到哪一個。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
fromIndex 要搜索的第一個元素(包括)的索引
toIndex 要搜索的最后一個元素(不包括)的索引
key 要搜索的值

返回:

搜索鍵的索引,如果它包含在指定范圍內(nèi)的數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為鍵將插入數(shù)組的點:范圍中大于鍵的第一個元素的索引,如果范圍內(nèi)的所有元素都小于指定的鍵,則為 toIndex。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
ClassCastException 如果搜索鍵與指定范圍內(nèi)的數(shù)組元素不可比較。
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

binarySearch

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

使用二分搜索算法在指定數(shù)組中搜索指定對象。 在進(jìn)行此調(diào)用之前,必須根據(jù)指定的比較器(如通過 [sort(T], Comparator) 方法)對數(shù)組進(jìn)行升序排序。 如果未排序,則結(jié)果未定義。 如果數(shù)組包含多個等于指定對象的元素,則無法保證會找到哪一個。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組中對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
key 要搜索的值
c 排序數(shù)組的比較器。 空值表示應(yīng)該使用元素的 Comparable。

返回:

搜索鍵的索引,如果它包含在數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為將鍵插入數(shù)組的點:第一個元素的索引大于鍵,或者如果數(shù)組中的所有元素都小于指定的鍵,則為 a.length。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
ClassCastException 如果數(shù)組包含使用指定比較器無法相互比較的元素,或者搜索鍵與使用此比較器的數(shù)組元素不可比較。

binarySearch

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

使用二分搜索算法在指定數(shù)組的范圍內(nèi)搜索指定對象。 在進(jìn)行此調(diào)用之前,必須根據(jù)指定的比較器(如通過 [sort(T], int, int, Comparator) 方法)對范圍進(jìn)行升序排序。 如果未排序,則結(jié)果未定義。 如果范圍包含多個等于指定對象的元素,則無法保證會找到哪一個。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組中對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要搜索的數(shù)組
fromIndex 要搜索的第一個元素(包括)的索引
toIndex 要搜索的最后一個元素(不包括)的索引
key 要搜索的值
c 排序數(shù)組的比較器。 空值表示應(yīng)該使用元素的 Comparable。

返回:

搜索鍵的索引,如果它包含在指定范圍內(nèi)的數(shù)組中; 否則,(-(插入點)- 1)。 插入點定義為鍵將插入數(shù)組的點:范圍中大于鍵的第一個元素的索引,如果范圍內(nèi)的所有元素都小于指定的鍵,則為 toIndex。 請注意,這保證了當(dāng)且僅當(dāng)找到鍵時,返回值將 >= 0。

Throws:

Throw名稱 Throw描述
ClassCastException 如果范圍包含使用指定比較器無法相互比較的元素,或者搜索鍵與使用此比較器的范圍內(nèi)的元素不可比較。
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

equals

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

如果兩個指定的 long 數(shù)組彼此相等,則返回 true。 如果兩個數(shù)組包含相同數(shù)量的元素,并且兩個數(shù)組中所有對應(yīng)的元素對相等,則認(rèn)為兩個數(shù)組相等。 換句話說,如果兩個數(shù)組以相同的順序包含相同的元素,則它們是相等的。 此外,如果兩個數(shù)組引用都為空,則認(rèn)為兩個數(shù)組引用相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 一個要測試是否相等的數(shù)組
a2 要測試相等性的另一個數(shù)組

返回:

如果兩個數(shù)組相等則為true

equals

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

如果兩個指定的 int 數(shù)組彼此相等,則返回 true。 如果兩個數(shù)組包含相同數(shù)量的元素,并且兩個數(shù)組中所有對應(yīng)的元素對相等,則認(rèn)為兩個數(shù)組相等。 換句話說,如果兩個數(shù)組以相同的順序包含相同的元素,則它們是相等的。 此外,如果兩個數(shù)組引用都為空,則認(rèn)為兩個數(shù)組引用相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 一個要測試是否相等的數(shù)組
a2 要測試相等性的另一個數(shù)組

返回:

如果兩個數(shù)組相等則為true

equals

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

如果兩個指定的 short 數(shù)組彼此相等,則返回 true。 如果兩個數(shù)組包含相同數(shù)量的元素,并且兩個數(shù)組中所有對應(yīng)的元素對相等,則認(rèn)為兩個數(shù)組相等。 換句話說,如果兩個數(shù)組以相同的順序包含相同的元素,則它們是相等的。 此外,如果兩個數(shù)組引用都為空,則認(rèn)為兩個數(shù)組引用相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 一個要測試是否相等的數(shù)組
a2 要測試相等性的另一個數(shù)組

返回:

如果兩個數(shù)組相等則為true

equals

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

如果兩個指定的字符數(shù)組彼此相等,則返回 true。 如果兩個數(shù)組包含相同數(shù)量的元素,并且兩個數(shù)組中所有對應(yīng)的元素對相等,則認(rèn)為兩個數(shù)組相等。 換句話說,如果兩個數(shù)組以相同的順序包含相同的元素,則它們是相等的。 此外,如果兩個數(shù)組引用都為空,則認(rèn)為兩個數(shù)組引用相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 一個要測試是否相等的數(shù)組
a2 要測試相等性的另一個數(shù)組

返回:

如果兩個數(shù)組相等則為true

equals

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

如果兩個指定的字節(jié)數(shù)組彼此相等,則返回 true。 如果兩個數(shù)組包含相同數(shù)量的元素,并且兩個數(shù)組中所有對應(yīng)的元素對相等,則認(rèn)為兩個數(shù)組相等。 換句話說,如果兩個數(shù)組以相同的順序包含相同的元素,則它們是相等的。 此外,如果兩個數(shù)組引用都為空,則認(rèn)為兩個數(shù)組引用相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 一個要測試是否相等的數(shù)組
a2 要測試相等性的另一個數(shù)組

返回:

如果兩個數(shù)組相等則為true

equals

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

如果兩個指定的布爾值數(shù)組彼此相等,則返回 true。 如果兩個數(shù)組包含相同數(shù)量的元素,并且兩個數(shù)組中所有對應(yīng)的元素對相等,則認(rèn)為兩個數(shù)組相等。 換句話說,如果兩個數(shù)組以相同的順序包含相同的元素,則它們是相等的。 此外,如果兩個數(shù)組引用都為空,則認(rèn)為兩個數(shù)組引用相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 一個要測試是否相等的數(shù)組
a2 要測試相等性的另一個數(shù)組

返回:

如果兩個數(shù)組相等則為true

equals

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

如果兩個指定的雙精度數(shù)組彼此相等,則返回 true。 如果兩個數(shù)組包含相同數(shù)量的元素,并且兩個數(shù)組中所有對應(yīng)的元素對相等,則認(rèn)為兩個數(shù)組相等。 換句話說,如果兩個數(shù)組以相同的順序包含相同的元素,則它們是相等的。 此外,如果兩個數(shù)組引用都為空,則認(rèn)為兩個數(shù)組引用相等。

如果滿足以下條件,則認(rèn)為兩個雙精度 d1 和 d2 相等:

    new Double(d1).equals(new Double(d2))

(與 == 運(yùn)算符不同,此方法認(rèn)為 NaN 等于自身,并且 0.0d 不等于 -0.0d。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 一個要測試是否相等的數(shù)組
a2 要測試相等性的另一個數(shù)組

返回:

如果兩個數(shù)組相等則為true

equals

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

如果兩個指定的浮點數(shù)組彼此相等,則返回 true。 如果兩個數(shù)組包含相同數(shù)量的元素,并且兩個數(shù)組中所有對應(yīng)的元素對相等,則認(rèn)為兩個數(shù)組相等。 換句話說,如果兩個數(shù)組以相同的順序包含相同的元素,則它們是相等的。 此外,如果兩個數(shù)組引用都為空,則認(rèn)為兩個數(shù)組引用相等。

如果滿足以下條件,則認(rèn)為兩個浮點 f1 和 f2 相等:

    new Float(f1).equals(new Float(f2))

(與 == 運(yùn)算符不同,此方法認(rèn)為 NaN 等于自身,并且 0.0f 不等于 -0.0f。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 一個要測試是否相等的數(shù)組
a2 要測試相等性的另一個數(shù)組

返回:

如果兩個數(shù)組相等則為true

equals

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

如果兩個指定的 Objects 數(shù)組彼此相等,則返回 true。 如果兩個數(shù)組包含相同數(shù)量的元素,并且兩個數(shù)組中所有對應(yīng)的元素對相等,則認(rèn)為這兩個數(shù)組相等。 如果 (e1==null ? e2==null : e1.equals(e2)),則認(rèn)為兩個對象 e1 和 e2 相等。 換句話說,如果兩個數(shù)組以相同的順序包含相同的元素,則它們是相等的。 此外,如果兩個數(shù)組引用都為空,則認(rèn)為兩個數(shù)組引用相等。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 一個要測試是否相等的數(shù)組
a2 要測試相等性的另一個數(shù)組

返回:

如果兩個數(shù)組相等則為true

fill

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

將指定的 long 值分配給指定的 long 數(shù)組的每個元素。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
val 要存儲在數(shù)組的所有元素中的值

fill

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

將指定的 long 值分配給指定 long 數(shù)組的指定范圍的每個元素。 要填充的范圍從 index fromIndex(含)擴(kuò)展到 index toIndex(不含)。 (如果fromIndex==toIndex,則要填充的范圍為空。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
fromIndex 要填充指定值的第一個元素(包括)的索引
toIndex 要填充指定值的最后一個元素(不包括)的索引
val 要存儲在數(shù)組的所有元素中的值

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

fill

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

將指定的 int 值分配給指定的 int 數(shù)組的每個元素。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
val 要存儲在數(shù)組的所有元素中的值

fill

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

將指定的 int 值分配給指定 int 數(shù)組的指定范圍的每個元素。 要填充的范圍從 index fromIndex(含)擴(kuò)展到 index toIndex(不含)。 (如果fromIndex==toIndex,則要填充的范圍為空。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
fromIndex 要填充指定值的第一個元素(包括)的索引
toIndex 要填充指定值的最后一個元素(不包括)的索引
val 要存儲在數(shù)組的所有元素中的值

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

fill

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

將指定的 short 值分配給指定的 short 數(shù)組的每個元素。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
val 要存儲在數(shù)組的所有元素中的值

fill

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

將指定的 short 值分配給指定的 short 數(shù)組的指定范圍的每個元素。 要填充的范圍從 index fromIndex(含)擴(kuò)展到 index toIndex(不含)。 (如果fromIndex==toIndex,則要填充的范圍為空。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
fromIndex 要填充指定值的第一個元素(包括)的索引
toIndex 要填充指定值的最后一個元素(不包括)的索引
val 要存儲在數(shù)組的所有元素中的值

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

fill

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

將指定的 char 值分配給指定的 char 數(shù)組的每個元素。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
val 要存儲在數(shù)組的所有元素中的值

fill

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

將指定的 char 值分配給指定字符數(shù)組的指定范圍的每個元素。 要填充的范圍從 index fromIndex(含)擴(kuò)展到 index toIndex(不含)。 (如果fromIndex==toIndex,則要填充的范圍為空。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
fromIndex 要填充指定值的第一個元素(包括)的索引
toIndex 要填充指定值的最后一個元素(不包括)的索引
val 要存儲在數(shù)組的所有元素中的值

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

fill

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

將指定的字節(jié)值分配給指定字節(jié)數(shù)組的每個元素。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
val 要存儲在數(shù)組的所有元素中的值

fill

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

將指定的字節(jié)值分配給指定字節(jié)數(shù)組的指定范圍的每個元素。 要填充的范圍從 index fromIndex(含)擴(kuò)展到 index toIndex(不含)。 (如果fromIndex==toIndex,則要填充的范圍為空。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
fromIndex 要填充指定值的第一個元素(包括)的索引
toIndex 要填充指定值的最后一個元素(不包括)的索引
val 要存儲在數(shù)組的所有元素中的值

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

fill

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

將指定的布爾值分配給指定的布爾數(shù)組的每個元素。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
val 要存儲在數(shù)組的所有元素中的值

fill

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

將指定的布爾值分配給指定布爾數(shù)組的指定范圍的每個元素。 要填充的范圍從 index fromIndex(含)擴(kuò)展到 index toIndex(不含)。 (如果fromIndex==toIndex,則要填充的范圍為空。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
fromIndex 要填充指定值的第一個元素(包括)的索引
toIndex 要填充指定值的最后一個元素(不包括)的索引
val 要存儲在數(shù)組的所有元素中的值

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

fill

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

將指定的 double 值分配給指定的 double 數(shù)組的每個元素。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
val 要存儲在數(shù)組的所有元素中的值

fill

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

將指定的 double 值分配給指定的 double 數(shù)組的指定范圍內(nèi)的每個元素。 要填充的范圍從 index fromIndex(含)擴(kuò)展到 index toIndex(不含)。 (如果fromIndex==toIndex,則要填充的范圍為空。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
fromIndex 要填充指定值的第一個元素(包括)的索引
toIndex 要填充指定值的最后一個元素(不包括)的索引
val 要存儲在數(shù)組的所有元素中的值

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

fill

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

將指定的浮點值分配給指定浮點數(shù)組的每個元素。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
val 要存儲在數(shù)組的所有元素中的值

fill

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

將指定的浮點值分配給指定浮點數(shù)組的指定范圍的每個元素。 要填充的范圍從 index fromIndex(含)擴(kuò)展到 index toIndex(不含)。 (如果fromIndex==toIndex,則要填充的范圍為空。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
fromIndex 要填充指定值的第一個元素(包括)的索引
toIndex 要填充指定值的最后一個元素(不包括)的索引
val 要存儲在數(shù)組的所有元素中的值

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length

fill

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

將指定的 Object 引用分配給指定的 Objects 數(shù)組的每個元素。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
val 要存儲在數(shù)組的所有元素中的值

Throws:

Throw名稱 Throw描述
ArrayStoreException 如果指定的值不是可以存儲在指定數(shù)組中的運(yùn)行時類型

fill

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

將指定的 Object 引用分配給指定的 Objects 數(shù)組的指定范圍內(nèi)的每個元素。 要填充的范圍從 index fromIndex(含)擴(kuò)展到 index toIndex(不含)。 (如果fromIndex==toIndex,則要填充的范圍為空。)

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要填充的數(shù)組
fromIndex 要填充指定值的第一個元素(包括)的索引
toIndex 要填充指定值的最后一個元素(不包括)的索引
val 要存儲在數(shù)組的所有元素中的值

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 fromIndex > toIndex
ArrayIndexOutOfBoundsException 如果 fromIndex < 0 或 toIndex > a.length
ArrayStoreException 如果指定的值不是可以存儲在指定數(shù)組中的運(yùn)行時類型

copyOf

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

復(fù)制指定的數(shù)組,截斷或填充空值(如有必要),使副本具有指定的長度。 對于在原始數(shù)組和副本中都有效的所有索引,這兩個數(shù)組將包含相同的值。 對于在副本中有效但在原始副本中無效的任何索引,副本將包含 null。 當(dāng)且僅當(dāng)指定長度大于原始數(shù)組的長度時,此類索引才會存在。 結(jié)果數(shù)組與原始數(shù)組的類完全相同。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組中對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要復(fù)制的數(shù)組
newLength 要返回的副本的長度

返回:

原始數(shù)組的副本,被截斷或用空值填充以獲得指定的長度

Throws:

Throw名稱 Throw描述
NegativeArraySizeException 如果 newLength 為負(fù)
NullPointerException 如果 original 為空

copyOf

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

復(fù)制指定的數(shù)組,截斷或填充空值(如有必要),使副本具有指定的長度。 對于在原始數(shù)組和副本中都有效的所有索引,這兩個數(shù)組將包含相同的值。 對于在副本中有效但在原始副本中無效的任何索引,副本將包含 null。 當(dāng)且僅當(dāng)指定長度大于原始數(shù)組的長度時,此類索引才會存在。 結(jié)果數(shù)組屬于 newType 類。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
U 原始數(shù)組中對象的類
T 返回數(shù)組中對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要復(fù)制的數(shù)組
newLength 要返回的副本的長度
newType 要返回的副本的類別

返回:

原始數(shù)組的副本,被截斷或用空值填充以獲得指定的長度

Throws:

Throw名稱 Throw描述
NegativeArraySizeException 如果 newLength 為負(fù)
NullPointerException 如果 original 為空
ArrayStoreException 如果從原始復(fù)制的元素不是可以存儲在類 newType 數(shù)組中的運(yùn)行時類型

copyOf

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

復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。 對于在原始數(shù)組和副本中都有效的所有索引,這兩個數(shù)組將包含相同的值。 對于在副本中有效但在原始副本中無效的任何索引,副本將包含 (byte)0。 當(dāng)且僅當(dāng)指定長度大于原始數(shù)組的長度時,此類索引才會存在。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要復(fù)制的數(shù)組
newLength 要返回的副本的長度

返回:

原始數(shù)組的副本,被截斷或用零填充以獲得指定的長度

Throws:

Throw名稱 Throw描述
NegativeArraySizeException 如果 newLength 為負(fù)
NullPointerException 如果 original 為空

copyOf

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

復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。 對于在原始數(shù)組和副本中都有效的所有索引,這兩個數(shù)組將包含相同的值。 對于在副本中有效但在原始副本中無效的任何索引,副本將包含(短)0。 當(dāng)且僅當(dāng)指定長度大于原始數(shù)組的長度時,此類索引才會存在。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要復(fù)制的數(shù)組
newLength 要返回的副本的長度

返回:

原始數(shù)組的副本,被截斷或用零填充以獲得指定的長度

Throws:

Throw名稱 Throw描述
NegativeArraySizeException 如果 newLength 為負(fù)
NullPointerException 如果 original 為空

copyOf

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

復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。 對于在原始數(shù)組和副本中都有效的所有索引,這兩個數(shù)組將包含相同的值。 對于在副本中有效但在原始數(shù)組中無效的任何索引,副本將包含 0。當(dāng)且僅當(dāng)指定長度大于原始數(shù)組的長度時,此類索引才會存在。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要復(fù)制的數(shù)組
newLength 要返回的副本的長度

返回:

原始數(shù)組的副本,被截斷或用零填充以獲得指定的長度

Throws:

Throw名稱 Throw描述
NegativeArraySizeException 如果 newLength 為負(fù)
NullPointerException 如果 original 為空

copyOf

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

復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。 對于在原始數(shù)組和副本中都有效的所有索引,這兩個數(shù)組將包含相同的值。 對于在副本中有效但在原始副本中無效的任何索引,副本將包含 0L。 當(dāng)且僅當(dāng)指定長度大于原始數(shù)組的長度時,此類索引才會存在。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要復(fù)制的數(shù)組
newLength 要返回的副本的長度

返回:

原始數(shù)組的副本,被截斷或用零填充以獲得指定的長度

Throws:

Throw名稱 Throw描述
NegativeArraySizeException 如果 newLength 為負(fù)
NullPointerException 如果 original 為空

copyOf

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

復(fù)制指定的數(shù)組,用空字符截斷或填充(如有必要),使副本具有指定的長度。 對于在原始數(shù)組和副本中都有效的所有索引,這兩個數(shù)組將包含相同的值。 對于在副本中有效但在原始副本中無效的任何索引,副本將包含“\u000”。 當(dāng)且僅當(dāng)指定長度大于原始數(shù)組的長度時,此類索引才會存在。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要復(fù)制的數(shù)組
newLength 要返回的副本的長度

返回:

原始數(shù)組的副本,被截斷或用空字符填充以獲得指定的長度

Throws:

Throw名稱 Throw描述
NegativeArraySizeException 如果 newLength 為負(fù)
NullPointerException 如果 original 為空

copyOf

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

復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。 對于在原始數(shù)組和副本中都有效的所有索引,這兩個數(shù)組將包含相同的值。 對于在副本中有效但不是原始索引的任何索引,副本將包含 0f。 當(dāng)且僅當(dāng)指定長度大于原始數(shù)組的長度時,此類索引才會存在。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要復(fù)制的數(shù)組
newLength 要返回的副本的長度

返回:

原始數(shù)組的副本,被截斷或用零填充以獲得指定的長度

Throws:

Throw名稱 Throw描述
NegativeArraySizeException 如果 newLength 為負(fù)
NullPointerException 如果 original 為空

copyOf

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

復(fù)制指定的數(shù)組,用零截斷或填充(如有必要),以便副本具有指定的長度。 對于在原始數(shù)組和副本中都有效的所有索引,這兩個數(shù)組將包含相同的值。 對于在副本中有效但不是原始索引的任何索引,副本將包含 0d。 當(dāng)且僅當(dāng)指定長度大于原始數(shù)組的長度時,此類索引才會存在。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要復(fù)制的數(shù)組
newLength 要返回的副本的長度

返回:

原始數(shù)組的副本,被截斷或用零填充以獲得指定的長度

Throws:

Throw名稱 Throw描述
NegativeArraySizeException 如果 newLength 為負(fù)
NullPointerException 如果 original 為空

copyOf

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

復(fù)制指定的數(shù)組,用 false 截斷或填充(如果需要),使副本具有指定的長度。 對于在原始數(shù)組和副本中都有效的所有索引,這兩個數(shù)組將包含相同的值。 對于在副本中有效但在原始副本中無效的任何索引,副本將包含 false。 當(dāng)且僅當(dāng)指定長度大于原始數(shù)組的長度時,此類索引才會存在。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要復(fù)制的數(shù)組
newLength 要返回的副本的長度

返回:

原始數(shù)組的副本,被截斷或填充假元素以獲得指定的長度

Throws:

Throw名稱 Throw描述
NegativeArraySizeException 如果 newLength 為負(fù)
NullPointerException 如果 original 為空

copyOfRange

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

將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。 范圍 (from) 的初始索引必須介于零和 original.length 之間,包括兩者。 original[from] 的值被放入副本的初始元素中(除非 from == original.length 或 from == to)。 原始數(shù)組中后續(xù)元素的值被放入副本中的后續(xù)元素中。 范圍(to)的最終索引,必須大于或等于 from,可能大于 original.length,在這種情況下,null 放置在索引大于或等于 original 的副本的所有元素中。 長度 - 從。 返回數(shù)組的長度將是 to - from。

結(jié)果數(shù)組與原始數(shù)組的類完全相同。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組中對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要從中復(fù)制范圍的數(shù)組
from 要復(fù)制的范圍的初始索引,包括
to 要復(fù)制的范圍的最終索引,獨占。 (此索引可能位于數(shù)組之外。)

返回:

包含原始數(shù)組中指定范圍的新數(shù)組,截斷或填充空值以獲得所需的長度

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 from < 0 或者 from > original.length
IllegalArgumentException 如果 from > to
NullPointerException 如果 original 為空

copyOfRange

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

將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。 范圍 (from) 的初始索引必須介于零和 original.length 之間,包括兩者。 original[from] 的值被放入副本的初始元素中(除非 from == original.length 或 from == to)。 原始數(shù)組中后續(xù)元素的值被放入副本中的后續(xù)元素中。 范圍(to)的最終索引,必須大于或等于 from,可能大于 original.length,在這種情況下,null 放置在索引大于或等于 original 的副本的所有元素中。 長度 - 從。 返回數(shù)組的長度將是 to - from。 結(jié)果數(shù)組屬于 newType 類。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
U 原始數(shù)組中對象的類
T 返回數(shù)組中對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要從中復(fù)制范圍的數(shù)組
from 要復(fù)制的范圍的初始索引,包括
to 要復(fù)制的范圍的最終索引,獨占。 (此索引可能位于數(shù)組之外。)
newType 要返回的副本的類別

返回:

包含原始數(shù)組中指定范圍的新數(shù)組,截斷或填充空值以獲得所需的長度

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 from < 0 或 from > original.length
IllegalArgumentException 如果 from > to
NullPointerException 如果 original 為空
ArrayStoreException 如果從原始元素復(fù)制的元素不是可以存儲在類 newType 數(shù)組中的運(yùn)行時類型。

copyOfRange

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

將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。 范圍 (from) 的初始索引必須介于零和 original.length 之間,包括兩者。 original[from] 的值被放入副本的初始元素中(除非 from == original.length 或 from == to)。 原始數(shù)組中后續(xù)元素的值被放入副本中的后續(xù)元素中。 范圍(to)的最終索引,必須大于等于from,可能大于original.length,這種情況下(byte)0被放置在索引大于等于的副本的所有元素中 到 original.length - 從。 返回數(shù)組的長度將是 to - from。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要從中復(fù)制范圍的數(shù)組
from 要復(fù)制的范圍的初始索引,包括
to 要復(fù)制的范圍的最終索引,獨占。 (此索引可能位于數(shù)組之外。)

返回:

包含原始數(shù)組中指定范圍的新數(shù)組,截斷或填充零以獲得所需的長度

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 from < 0 或 from > original.length
IllegalArgumentException 如果 from > to
NullPointerException 如果 original 為空

copyOfRange

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

將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。 范圍 (from) 的初始索引必須介于零和 original.length 之間,包括兩者。 original[from] 的值被放入副本的初始元素中(除非 from == original.length 或 from == to)。 原始數(shù)組中后續(xù)元素的值被放入副本中的后續(xù)元素中。 范圍(to)的最終索引,必須大于或等于from,可能大于original.length,這種情況下(short)0被放置在索引大于或等于副本的所有元素中 到 original.length - 從。 返回數(shù)組的長度將是 to - from。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要從中復(fù)制范圍的數(shù)組
from 要復(fù)制的范圍的初始索引,包括
to 要復(fù)制的范圍的最終索引,獨占。 (此索引可能位于數(shù)組之外。)

返回:

包含原始數(shù)組中指定范圍的新數(shù)組,截斷或填充零以獲得所需的長度

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 from < 0 或 from > original.length
IllegalArgumentException 如果 from > to
NullPointerException 如果 original 為空

copyOfRange

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

將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。 范圍 (from) 的初始索引必須介于零和 original.length 之間,包括兩者。 original[from] 的值被放入副本的初始元素中(除非 from == original.length 或 from == to)。 原始數(shù)組中后續(xù)元素的值被放入副本中的后續(xù)元素中。 范圍(to)的最終索引,必須大于或等于from,可能大于original.length,在這種情況下,0被放置在索引大于或等于original的副本的所有元素中。 長度 - 從。 返回數(shù)組的長度將是 to - from。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要從中復(fù)制范圍的數(shù)組
from 要復(fù)制的范圍的初始索引,包括
to 要復(fù)制的范圍的最終索引,獨占。 (此索引可能位于數(shù)組之外。)

返回:

包含原始數(shù)組中指定范圍的新數(shù)組,截斷或填充零以獲得所需的長度

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 from < 0 或 from > original.length
IllegalArgumentException 如果 from > to
NullPointerException 如果 original 為空

copyOfRange

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

將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。 范圍 (from) 的初始索引必須介于零和 original.length 之間,包括兩者。 original[from] 的值被放入副本的初始元素中(除非 from == original.length 或 from == to)。 原始數(shù)組中后續(xù)元素的值被放入副本中的后續(xù)元素中。 范圍(to)的最終索引,必須大于或等于from,可能大于original.length,這種情況下,0L被放置在索引大于或等于original的副本的所有元素中。 長度 - 從。 返回數(shù)組的長度將是 to - from。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要從中復(fù)制范圍的數(shù)組
from 要復(fù)制的范圍的初始索引,包括
to 要復(fù)制的范圍的最終索引,獨占。 (此索引可能位于數(shù)組之外。)

返回:

包含原始數(shù)組中指定范圍的新數(shù)組,截斷或填充零以獲得所需的長度

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 from < 0 或 from > original.length
IllegalArgumentException 如果 from > to
NullPointerException 如果 original 為空

copyOfRange

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

將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。 范圍 (from) 的初始索引必須介于零和 original.length 之間,包括兩者。 original[from] 的值被放入副本的初始元素中(除非 from == original.length 或 from == to)。 原始數(shù)組中后續(xù)元素的值被放入副本中的后續(xù)元素中。 范圍(to)的最終索引,必須大于等于from,可能大于original.length,這種情況下'\u000'被放置在所有索引大于等于的副本的元素中 到 original.length - 從。 返回數(shù)組的長度將是 to - from。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要從中復(fù)制范圍的數(shù)組
from 要復(fù)制的范圍的初始索引,包括
to 要復(fù)制的范圍的最終索引,獨占。 (此索引可能位于數(shù)組之外。)

返回:

包含原始數(shù)組中指定范圍的新數(shù)組,截斷或填充空字符以獲得所需的長度

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 from < 0 或 from > original.length
IllegalArgumentException 如果 from > to
NullPointerException 如果 original 為空

copyOfRange

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

將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。 范圍 (from) 的初始索引必須介于零和 original.length 之間,包括兩者。 original[from] 的值被放入副本的初始元素中(除非 from == original.length 或 from == to)。 原始數(shù)組中后續(xù)元素的值被放入副本中的后續(xù)元素中。 范圍(to)的最終索引,必須大于或等于from,可能大于original.length,在這種情況下,0f被放置在索引大于或等于original的副本的所有元素中。 長度 - 從。 返回數(shù)組的長度將是 to - from。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要從中復(fù)制范圍的數(shù)組
from 要復(fù)制的范圍的初始索引,包括
to 要復(fù)制的范圍的最終索引,獨占。 (此索引可能位于數(shù)組之外。)

返回:

包含原始數(shù)組中指定范圍的新數(shù)組,截斷或填充零以獲得所需的長度

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 from < 0 或 from > original.length
IllegalArgumentException 如果 from > to
NullPointerException 如果 original 為空

copyOfRange

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

將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。 范圍 (from) 的初始索引必須介于零和 original.length 之間,包括兩者。 original[from] 的值被放入副本的初始元素中(除非 from == original.length 或 from == to)。 原始數(shù)組中后續(xù)元素的值被放入副本中的后續(xù)元素中。 范圍(to)的最終索引,必須大于或等于from,可能大于original.length,在這種情況下,0d被放置在索引大于或等于original的副本的所有元素中。 長度 - 從。 返回數(shù)組的長度將是 to - from。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要從中復(fù)制范圍的數(shù)組
from 要復(fù)制的范圍的初始索引,包括
to 要復(fù)制的范圍的最終索引,獨占。 (此索引可能位于數(shù)組之外。)

返回:

包含原始數(shù)組中指定范圍的新數(shù)組,截斷或填充零以獲得所需的長度

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 from < 0 或 from > original.length
IllegalArgumentException 如果 from > to
NullPointerException 如果 original 為空

copyOfRange

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

將指定數(shù)組的指定范圍復(fù)制到新數(shù)組中。 范圍 (from) 的初始索引必須介于零和 original.length 之間,包括兩者。 original[from] 的值被放入副本的初始元素中(除非 from == original.length 或 from == to)。 原始數(shù)組中后續(xù)元素的值被放入副本中的后續(xù)元素中。 范圍(to)的最終索引,必須大于或等于from,可能大于original.length,在這種情況下,false 被放置在索引大于或等于original 的副本的所有元素中。 長度 - 從。 返回數(shù)組的長度將是 to - from。

參數(shù):

參數(shù)名稱 參數(shù)描述
original 要從中復(fù)制范圍的數(shù)組
from 要復(fù)制的范圍的初始索引,包括
to 要復(fù)制的范圍的最終索引,獨占。 (此索引可能位于數(shù)組之外。)

返回:

包含原始數(shù)組中指定范圍的新數(shù)組,截斷或填充錯誤元素以獲得所需的長度

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 from < 0 或 from > original.length
IllegalArgumentException 如果 from > to
NullPointerException 如果 original 為空

asList

@SafeVarargs public static <T> List<T> asList(T... a)

返回由指定數(shù)組支持的固定大小的列表。 (將返回的列表“寫入”到數(shù)組的更改。)此方法充當(dāng)基于數(shù)組和基于集合的 API 之間的橋梁,與 Collection#toArray 結(jié)合使用。 返回的列表是可序列化的并實現(xiàn)了 RandomAccess。

此方法還提供了一種方便的方法來創(chuàng)建一個固定大小的列表,該列表已初始化為包含多個元素:

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

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組中對象的類

參數(shù):

參數(shù)名稱 參數(shù)描述
a 將支持列表的數(shù)組

返回:

指定數(shù)組的列表視圖

hashCode

public static int hashCode(long[] a)

根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。 對于任意兩個長數(shù)組 a 和 b 使得 Arrays.equals(a, b),Arrays.hashCode(a) == Arrays.hashCode(b) 也是如此。

此方法返回的值與通過在 List 上調(diào)用 List#hashCode() 方法獲得的值相同,該 List 包含以相同順序表示 a 的元素的 Long 實例序列。 如果 a 為 null,則此方法返回 0。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要計算其哈希值的數(shù)組

返回:

一個基于內(nèi)容的哈希碼

hashCode

public static int hashCode(int[] a)

根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。 對于任意兩個非空 int 數(shù)組 a 和 b 使得 Arrays.equals(a, b),Arrays.hashCode(a) == Arrays.hashCode(b) 也是如此。

此方法返回的值與通過在 List 上調(diào)用 List#hashCode() 方法獲得的值相同,該 List 包含以相同順序表示 a 的元素的 Integer 實例序列。 如果 a 為 null,則此方法返回 0。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要計算其哈希值的數(shù)組

返回:

一個基于內(nèi)容的哈希碼

hashCode

public static int hashCode(short[] a)

根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。 對于任意兩個短數(shù)組 a 和 b 使得 Arrays.equals(a, b),Arrays.hashCode(a) == Arrays.hashCode(b) 也是如此。

此方法返回的值與通過在 List 上調(diào)用 List#hashCode() 方法獲得的值相同,該 List 包含以相同順序表示 a 的元素的一系列 Short 實例。 如果 a 為 null,則此方法返回 0。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要計算其哈希值的數(shù)組

返回:

一個基于內(nèi)容的哈希碼

hashCode

public static int hashCode(char[] a)

根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。 對于任意兩個 char 數(shù)組 a 和 b 使得 Arrays.equals(a, b),Arrays.hashCode(a) == Arrays.hashCode(b) 也是如此。

此方法返回的值與通過在 List 上調(diào)用 List#hashCode() 方法獲得的值相同,該 List 包含以相同順序表示 a 的元素的 Character 實例序列。 如果 a 為 null,則此方法返回 0。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要計算其哈希值的數(shù)組

返回:

一個基于內(nèi)容的哈希碼

hashCode

public static int hashCode(byte[] a)

根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。 對于任意兩個字節(jié)數(shù)組 a 和 b 使得 Arrays.equals(a, b),Arrays.hashCode(a) == Arrays.hashCode(b) 也是如此。

此方法返回的值與通過在 List 上調(diào)用 List#hashCode() 方法獲得的值相同,該 List 包含以相同順序表示 a 的元素的 Byte 實例序列。 如果 a 為 null,則此方法返回 0。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要計算其哈希值的數(shù)組

返回:

一個基于內(nèi)容的哈希碼

hashCode

public static int hashCode(boolean[] a)

根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。 對于任何兩個布爾數(shù)組 a 和 b 使得 Arrays.equals(a, b),Arrays.hashCode(a) == Arrays.hashCode(b) 也是如此。

此方法返回的值與通過在 List 上調(diào)用 List#hashCode() 方法獲得的值相同,該 List 包含以相同順序表示 a 元素的布爾實例序列。 如果 a 為 null,則此方法返回 0。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要計算其哈希值的數(shù)組

返回:

一個基于內(nèi)容的哈希碼

hashCode

public static int hashCode(float[] a)

根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。 對于任意兩個浮點數(shù)組 a 和 b 使得 Arrays.equals(a, b),Arrays.hashCode(a) == Arrays.hashCode(b) 也是如此。

此方法返回的值與通過在 List 上調(diào)用 List#hashCode() 方法獲得的值相同,該 List 包含以相同順序表示 a 的元素的 Float 實例序列。 如果 a 為 null,則此方法返回 0。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要計算其哈希值的數(shù)組

返回:

一個基于內(nèi)容的哈希碼

hashCode

public static int hashCode(double[] a)

根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。 對于任何兩個使 Arrays.equals(a, b) 的雙精度數(shù)組 a 和 b,Arrays.hashCode(a) == Arrays.hashCode(b) 也是如此。

此方法返回的值與通過在 List 上調(diào)用 List#hashCode() 方法獲得的值相同,該 List 包含以相同順序表示 a 的元素的 Double 實例序列。 如果 a 為 null,則此方法返回 0。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要計算其哈希值的數(shù)組

返回:

一個基于內(nèi)容的哈希碼

hashCode

public static int hashCode(Object[] a)

根據(jù)指定數(shù)組的內(nèi)容返回哈希碼。 如果數(shù)組包含其他數(shù)組作為元素,則哈希碼基于它們的身份而不是它們的內(nèi)容。 因此,可以直接或間接通過一個或多個級別的數(shù)組對包含自身作為元素的數(shù)組調(diào)用此方法。

對于任意兩個數(shù)組 a 和 b 使得 Arrays.equals(a, b),Arrays.hashCode(a) == Arrays.hashCode(b) 也是如此。

此方法返回的值等于 Arrays.asList(a).hashCode() 將返回的值,除非 a 為 null,在這種情況下返回 0。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要計算其基于內(nèi)容的哈希碼的數(shù)組

返回:

一個基于內(nèi)容的哈希碼

deepHashCode

public static int deepHashCode(Object[] a)

根據(jù)指定數(shù)組的“深層內(nèi)容”返回哈希碼。如果數(shù)組包含其他數(shù)組作為元素,則哈希碼基于它們的內(nèi)容等等,無窮無盡。因此,在包含自身作為元素的數(shù)組上直接或通過一層或多層數(shù)組間接調(diào)用此方法是不可接受的。這種調(diào)用的行為是未定義的。

對于任意兩個數(shù)組 a 和 b 滿足 Arrays.deepEquals(a, b),Arrays.deepHashCode(a) == Arrays.deepHashCode(b) 也是如此。

此方法返回的值的計算類似于 List#hashCode() 在包含與 a 相同元素的列表中返回的值的計算,但有一個區(qū)別:如果 a 的元素 e 本身是一個數(shù)組,它的哈希碼不是通過調(diào)用 e.hashCode() 來計算的,而是通過調(diào)用 Arrays.hashCode(e) 的適當(dāng)重載來計算,如果 e 是一個原始類型的數(shù)組,或者通過調(diào)用 Arrays.deepHashCode(e)如果 e 是引用類型的數(shù)組,則遞歸。如果 a 為 null,則此方法返回 0。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要計算其基于深度內(nèi)容的哈希碼的數(shù)組

返回:

一個基于深度內(nèi)容的哈希碼

deepEquals

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

如果兩個指定的數(shù)組彼此深度相等,則返回 true。 與 equals(java.lang.Object[],java.lang.Object[]) 方法不同,此方法適用于任意深度的嵌套數(shù)組。

如果兩個數(shù)組引用都為空,或者它們引用的數(shù)組包含相同數(shù)量的元素并且兩個數(shù)組中所有對應(yīng)的元素對都非常相等,則認(rèn)為兩個數(shù)組引用是深度相等的。

如果滿足以下任一條件,則兩個可能為 null 的元素 e1 和 e2 完全相等:

  • e1 和 e2 都是對象引用類型的數(shù)組,Arrays.deepEquals(e1, e2) 將返回 true
  • e1 和 e2 是相同原始類型的數(shù)組,并且 Arrays.equals(e1, e2) 的適當(dāng)重載將返回 true。
  • e1 == e2
  • e1.equals(e2) 將返回 true。

請注意,此定義允許任何深度的空元素。

如果任一指定的數(shù)組直接或通過一個或多個數(shù)組級別間接將自身包含為元素,則此方法的行為是未定義的。

參數(shù):

參數(shù)名稱 參數(shù)描述
a1 一個要測試是否相等的數(shù)組
a2 要測試相等性的另一個數(shù)組

返回:

如果兩個數(shù)組相等則為true

toString

public static String toString(long[] a)

返回指定數(shù)組內(nèi)容的字符串表示形式。 字符串表示由數(shù)組元素的列表組成,括在方括號 ("[]") 中。 相鄰元素由字符“,”(逗號后跟一個空格)分隔。 通過 String.valueOf(long) 將元素轉(zhuǎn)換為字符串。 如果 a 為空,則返回“空”。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要返回其字符串表示形式的數(shù)組

返回:

a 的字符串表示

toString

public static String toString(int[] a)

返回指定數(shù)組內(nèi)容的字符串表示形式。 字符串表示由數(shù)組元素的列表組成,括在方括號 ("[]") 中。 相鄰元素由字符“,”(逗號后跟一個空格)分隔。 通過 String.valueOf(int) 將元素轉(zhuǎn)換為字符串。 如果 a 為空,則返回“空”。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要返回其字符串表示形式的數(shù)組

返回:

a 的字符串表示

toString

public static String toString(short[] a)

返回指定數(shù)組內(nèi)容的字符串表示形式。 字符串表示由數(shù)組元素的列表組成,括在方括號 ("[]") 中。 相鄰元素由字符“,”(逗號后跟一個空格)分隔。 通過 String.valueOf(short) 將元素轉(zhuǎn)換為字符串。 如果 a 為空,則返回“空”。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要返回其字符串表示形式的數(shù)組

返回:

a 的字符串表示

toString

public static String toString(char[] a)

返回指定數(shù)組內(nèi)容的字符串表示形式。 字符串表示由數(shù)組元素的列表組成,括在方括號 ("[]") 中。 相鄰元素由字符“,”(逗號后跟一個空格)分隔。 通過 String.valueOf(char) 將元素轉(zhuǎn)換為字符串。 如果 a 為空,則返回“空”。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要返回其字符串表示形式的數(shù)組

返回:

a 的字符串表示

toString

public static String toString(byte[] a)

返回指定數(shù)組內(nèi)容的字符串表示形式。 字符串表示由數(shù)組元素的列表組成,括在方括號 ("[]") 中。 相鄰元素由字符“,”(逗號后跟一個空格)分隔。 通過 String.valueOf(byte) 將元素轉(zhuǎn)換為字符串。 如果 a 為空,則返回“空”。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要返回其字符串表示形式的數(shù)組

返回:

a 的字符串表示

toString

public static String toString(boolean[] a)

返回指定數(shù)組內(nèi)容的字符串表示形式。 字符串表示由數(shù)組元素的列表組成,括在方括號 ("[]") 中。 相鄰元素由字符“,”(逗號后跟一個空格)分隔。 通過 String.valueOf(boolean) 將元素轉(zhuǎn)換為字符串。 如果 a 為空,則返回“空”。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要返回其字符串表示形式的數(shù)組

返回:

a 的字符串表示

toString

public static String toString(float[] a)

返回指定數(shù)組內(nèi)容的字符串表示形式。 字符串表示由數(shù)組元素的列表組成,括在方括號 ("[]") 中。 相鄰元素由字符“,”(逗號后跟一個空格)分隔。 通過 String.valueOf(float) 將元素轉(zhuǎn)換為字符串。 如果 a 為空,則返回“空”。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要返回其字符串表示形式的數(shù)組

返回:

a 的字符串表示

toString

public static String toString(double[] a)

返回指定數(shù)組內(nèi)容的字符串表示形式。 字符串表示由數(shù)組元素的列表組成,括在方括號 ("[]") 中。 相鄰元素由字符“,”(逗號后跟一個空格)分隔。 通過 String.valueOf(double) 將元素轉(zhuǎn)換為字符串。 如果 a 為空,則返回“空”。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要返回其字符串表示形式的數(shù)組

返回:

a 的字符串表示

toString

public static String toString(Object[] a)

返回指定數(shù)組內(nèi)容的字符串表示形式。 如果數(shù)組包含其他數(shù)組作為元素,它們會通過繼承自 Object 的 Object#toString 方法轉(zhuǎn)換為字符串,該方法描述的是它們的標(biāo)識而不是它們的內(nèi)容。

此方法返回的值等于 Arrays.asList(a).toString() 將返回的值,除非 a 為 null,在這種情況下返回“null”。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要返回其字符串表示形式的數(shù)組

返回:

a 的字符串表示

deepToString

public static String deepToString(Object[] a)

返回指定數(shù)組的“深層內(nèi)容”的字符串表示形式。如果數(shù)組包含其他數(shù)組作為元素,則字符串表示包含它們的內(nèi)容等等。此方法設(shè)計用于將多維數(shù)組轉(zhuǎn)換為字符串。

字符串表示由數(shù)組元素的列表組成,括在方括號 ("[]") 中。相鄰元素由字符“,”(逗號后跟一個空格)分隔。元素通過 String.valueOf(Object) 轉(zhuǎn)換為字符串,除非它們本身是數(shù)組。

如果元素 e 是原始類型的數(shù)組,則通過調(diào)用 Arrays.toString(e) 的適當(dāng)重載將其轉(zhuǎn)換為字符串。如果元素 e 是引用類型的數(shù)組,則通過遞歸調(diào)用此方法將其轉(zhuǎn)換為字符串。

為避免無限遞歸,如果指定數(shù)組包含自身作為元素,或者包含通過一層或多層數(shù)組間接引用自身,則將自引用轉(zhuǎn)換為字符串“[...]”。例如,僅包含對其自身的引用的數(shù)組將呈現(xiàn)為“[[...]]”。

如果指定的數(shù)組為 null,則此方法返回“null”。

參數(shù):

參數(shù)名稱 參數(shù)描述
a 要返回其字符串表示形式的數(shù)組

返回:

a 的字符串表示

setAll

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

設(shè)置指定數(shù)組的所有元素,使用提供的生成器函數(shù)計算每個元素。

如果生成器函數(shù)拋出異常,則將其轉(zhuǎn)發(fā)給調(diào)用者,并且數(shù)組處于不確定狀態(tài)。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組元素的類型

參數(shù):

參數(shù)名稱 參數(shù)描述
array 要初始化的數(shù)組
generator 接受索引并為該位置生成所需值的函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果 generator 為空

parallelSetAll

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

使用提供的生成器函數(shù)并行設(shè)置指定數(shù)組的所有元素來計算每個元素。

如果生成器函數(shù)拋出異常,則從 parallelSetAll 中拋出未經(jīng)檢查的異常,并且數(shù)組處于不確定狀態(tài)。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組元素的類型

參數(shù):

參數(shù)名稱 參數(shù)描述
array 要初始化的數(shù)組
generator 接受索引并為該位置生成所需值的函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果 generator 為空

setAll

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

設(shè)置指定數(shù)組的所有元素,使用提供的生成器函數(shù)計算每個元素。

如果生成器函數(shù)拋出異常,則將其轉(zhuǎn)發(fā)給調(diào)用者,并且數(shù)組處于不確定狀態(tài)。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 要初始化的數(shù)組
generator 接受索引并為該位置生成所需值的函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果 generator 為空

parallelSetAll

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

使用提供的生成器函數(shù)并行設(shè)置指定數(shù)組的所有元素來計算每個元素。

如果生成器函數(shù)拋出異常,則從 parallelSetAll 中拋出未經(jīng)檢查的異常,并且數(shù)組處于不確定狀態(tài)。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 要初始化的數(shù)組
generator 接受索引并為該位置生成所需值的函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果 generator 為空

setAll

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

設(shè)置指定數(shù)組的所有元素,使用提供的生成器函數(shù)計算每個元素。

如果生成器函數(shù)拋出異常,則將其轉(zhuǎn)發(fā)給調(diào)用者,并且數(shù)組處于不確定狀態(tài)。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 要初始化的數(shù)組
generator 接受索引并為該位置生成所需值的函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果 generator 為空

parallelSetAll

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

使用提供的生成器函數(shù)并行設(shè)置指定數(shù)組的所有元素來計算每個元素。

如果生成器函數(shù)拋出異常,則從 parallelSetAll 中拋出未經(jīng)檢查的異常,并且數(shù)組處于不確定狀態(tài)。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 要初始化的數(shù)組
generator 接受索引并為該位置生成所需值的函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果 generator 為空

setAll

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

設(shè)置指定數(shù)組的所有元素,使用提供的生成器函數(shù)計算每個元素。

如果生成器函數(shù)拋出異常,則將其轉(zhuǎn)發(fā)給調(diào)用者,并且數(shù)組處于不確定狀態(tài)。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 要初始化的數(shù)組
generator 接受索引并為該位置生成所需值的函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果 generator 為空

parallelSetAll

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

使用提供的生成器函數(shù)并行設(shè)置指定數(shù)組的所有元素來計算每個元素。

如果生成器函數(shù)拋出異常,則從 parallelSetAll 中拋出未經(jīng)檢查的異常,并且數(shù)組處于不確定狀態(tài)。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 要初始化的數(shù)組
generator 接受索引并為該位置生成所需值的函數(shù)

Throws:

Throw名稱 Throw描述
NullPointerException 如果 generator 為空

spliterator

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

返回一個涵蓋所有指定數(shù)組的 Spliterator。

spliterator 報告 Spliterator#SIZED、Spliterator#SUBSIZED、Spliterator#ORDERED 和 Spliterator#IMMUTABLE。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 元素類型

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改

返回:

數(shù)組元素的拆分器

spliterator

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

返回一個Spliterator,覆蓋指定數(shù)組的指定范圍。

spliterator 報告 Spliterator#SIZED、Spliterator#SUBSIZED、Spliterator#ORDERED 和 Spliterator#IMMUTABLE。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 元素類型

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改
startInclusive 第一個涵蓋的索引,包括在內(nèi)
endExclusive 緊接著要覆蓋的最后一個索引的索引

返回:

數(shù)組元素的拆分器

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 startInclusive 為負(fù),則 endExclusive 小于 startInclusive,或者 endExclusive 大于數(shù)組大小

spliterator

public static Spliterator.OfInt spliterator(int[] array)

返回一個 Spliterator.OfInt 覆蓋所有指定的數(shù)組。

spliterator 報告 Spliterator#SIZED、Spliterator#SUBSIZED、Spliterator#ORDERED 和 Spliterator#IMMUTABLE。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改

返回:

數(shù)組元素的拆分器

spliterator

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

返回一個 Spliterator.OfInt 覆蓋指定數(shù)組的指定范圍。

spliterator 報告 Spliterator#SIZED、Spliterator#SUBSIZED、Spliterator#ORDERED 和 Spliterator#IMMUTABLE。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改
startInclusive 第一個涵蓋的索引,包括在內(nèi)
endExclusive 緊接著要覆蓋的最后一個索引的索引

返回:

數(shù)組元素的拆分器

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 startInclusive 為負(fù),則 endExclusive 小于 startInclusive,或者 endExclusive 大于數(shù)組大小

spliterator

public static Spliterator.OfLong spliterator(long[] array)

返回一個 Spliterator.OfLong 覆蓋所有指定的數(shù)組。

spliterator 報告 Spliterator#SIZED、Spliterator#SUBSIZED、Spliterator#ORDERED 和 Spliterator#IMMUTABLE。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改

返回:

數(shù)組元素的拆分器

spliterator

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

返回一個 Spliterator.OfLong 覆蓋指定數(shù)組的指定范圍。

spliterator 報告 Spliterator#SIZED、Spliterator#SUBSIZED、Spliterator#ORDERED 和 Spliterator#IMMUTABLE。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改
startInclusive 第一個涵蓋的索引,包括在內(nèi)
endExclusive 緊接著要覆蓋的最后一個索引的索引

返回:

數(shù)組元素的拆分器

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 startInclusive 為負(fù),則 endExclusive 小于 startInclusive,或者 endExclusive 大于數(shù)組大小

spliterator

public static Spliterator.OfDouble spliterator(double[] array)

返回一個 Spliterator.OfDouble 覆蓋所有指定的數(shù)組。

spliterator 報告 Spliterator#SIZED、Spliterator#SUBSIZED、Spliterator#ORDERED 和 Spliterator#IMMUTABLE。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改

返回:

數(shù)組元素的拆分器

spliterator

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

返回一個 Spliterator.OfDouble,覆蓋指定數(shù)組的指定范圍。

spliterator 報告 Spliterator#SIZED、Spliterator#SUBSIZED、Spliterator#ORDERED 和 Spliterator#IMMUTABLE。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改
startInclusive 第一個涵蓋的索引,包括在內(nèi)
endExclusive 緊接著要覆蓋的最后一個索引的索引

返回:

數(shù)組元素的拆分器

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 startInclusive 為負(fù),則 endExclusive 小于 startInclusive,或者 endExclusive 大于數(shù)組大小

stream

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

返回以指定數(shù)組為源的順序流。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組元素的類型

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假設(shè)在使用過程中未修改

返回:

數(shù)組的 Stream

stream

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

返回以指定數(shù)組的指定范圍作為源的順序流。

類型參數(shù):

類型參數(shù)名稱 類型參數(shù)描述
T 數(shù)組元素的類型

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改
startInclusive 第一個涵蓋的索引,包括在內(nèi)
endExclusive 緊接著要覆蓋的最后一個索引的索引

返回:

數(shù)組范圍的流

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 startInclusive 為負(fù),則 endExclusive 小于 startInclusive,或者 endExclusive 大于數(shù)組大小

stream

public static IntStream stream(int[] array)

返回以指定數(shù)組作為源的順序 IntStream。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改

返回:

數(shù)組的 IntStream

stream

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

返回以指定數(shù)組的指定范圍作為源的順序 IntStream。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改
startInclusive 第一個涵蓋的索引,包括在內(nèi)
endExclusive 緊接著要覆蓋的最后一個索引的索引

返回:

數(shù)組范圍的 IntStream

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 startInclusive 為負(fù),則 endExclusive 小于 startInclusive,或者 endExclusive 大于數(shù)組大小

stream

public static LongStream stream(long[] array)

返回以指定數(shù)組為源的順序 LongStream。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改

返回:

數(shù)組的 LongStream

stream

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

返回以指定數(shù)組的指定范圍作為源的順序 LongStream。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改
startInclusive 第一個涵蓋的索引,包括在內(nèi)
endExclusive 緊接著要覆蓋的最后一個索引的索引

返回:

數(shù)組范圍的 LongStream

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 startInclusive 為負(fù),則 endExclusive 小于 startInclusive,或者 endExclusive 大于數(shù)組大小

stream

public static DoubleStream stream(double[] array)

返回以指定數(shù)組為源的順序 DoubleStream。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改

返回:

數(shù)組的 DoubleStream

stream

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

返回以指定數(shù)組的指定范圍作為源的順序 DoubleStream。

參數(shù):

參數(shù)名稱 參數(shù)描述
array 數(shù)組,假定在使用期間未修改
startInclusive 第一個涵蓋的索引,包括在內(nèi)
endExclusive 緊接著要覆蓋的最后一個索引的索引

返回:

數(shù)組范圍的 DoubleStream

Throws:

Throw名稱 Throw描述
ArrayIndexOutOfBoundsException 如果 startInclusive 為負(fù),則 endExclusive 小于 startInclusive,或者 endExclusive 大于數(shù)組大小
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號