Lines Matching defs:to
8 * particular file as subject to the "Classpath" exception as provided
18 * 2 along with this work; if not, write to the Free Software Foundation,
51 * that allows arrays to be viewed as lists.
59 * <i>specification</i>. Implementors should feel free to substitute other
60 * algorithms, so long as the specification itself is adhered to. (For
61 * example, the algorithm used by {@code sort(Object[])} does not have to be
62 * a MergeSort, but it does have to be <i>stable</i>.)
140 * quicksorts to degrade to quadratic performance, and is typically
143 * @param a the array to be sorted
151 * to be sorted extends from the index {@code fromIndex}, inclusive, to
153 * the range to be sorted is empty.
158 * quicksorts to degrade to quadratic performance, and is typically
161 * @param a the array to be sorted
162 * @param fromIndex the index of the first element, inclusive, to be sorted
163 * @param toIndex the index of the last element, exclusive, to be sorted
180 * quicksorts to degrade to quadratic performance, and is typically
183 * @param a the array to be sorted
191 * to be sorted extends from the index {@code fromIndex}, inclusive, to
193 * the range to be sorted is empty.
198 * quicksorts to degrade to quadratic performance, and is typically
201 * @param a the array to be sorted
202 * @param fromIndex the index of the first element, inclusive, to be sorted
203 * @param toIndex the index of the last element, exclusive, to be sorted
220 * quicksorts to degrade to quadratic performance, and is typically
223 * @param a the array to be sorted
231 * to be sorted extends from the index {@code fromIndex}, inclusive, to
233 * the range to be sorted is empty.
238 * quicksorts to degrade to quadratic performance, and is typically
241 * @param a the array to be sorted
242 * @param fromIndex the index of the first element, inclusive, to be sorted
243 * @param toIndex the index of the last element, exclusive, to be sorted
260 * quicksorts to degrade to quadratic performance, and is typically
263 * @param a the array to be sorted
271 * to be sorted extends from the index {@code fromIndex}, inclusive, to
273 * the range to be sorted is empty.
278 * quicksorts to degrade to quadratic performance, and is typically
281 * @param a the array to be sorted
282 * @param fromIndex the index of the first element, inclusive, to be sorted
283 * @param toIndex the index of the last element, exclusive, to be sorted
300 * quicksorts to degrade to quadratic performance, and is typically
303 * @param a the array to be sorted
311 * to be sorted extends from the index {@code fromIndex}, inclusive, to
313 * the range to be sorted is empty.
318 * quicksorts to degrade to quadratic performance, and is typically
321 * @param a the array to be sorted
322 * @param fromIndex the index of the first element, inclusive, to be sorted
323 * @param toIndex the index of the last element, exclusive, to be sorted
339 * value compares neither less than, greater than, nor equal to any value,
348 * quicksorts to degrade to quadratic performance, and is typically
351 * @param a the array to be sorted
359 * to be sorted extends from the index {@code fromIndex}, inclusive, to
361 * the range to be sorted is empty.
365 * value compares neither less than, greater than, nor equal to any value,
374 * quicksorts to degrade to quadratic performance, and is typically
377 * @param a the array to be sorted
378 * @param fromIndex the index of the first element, inclusive, to be sorted
379 * @param toIndex the index of the last element, exclusive, to be sorted
395 * value compares neither less than, greater than, nor equal to any value,
404 * quicksorts to degrade to quadratic performance, and is typically
407 * @param a the array to be sorted
415 * to be sorted extends from the index {@code fromIndex}, inclusive, to
417 * the range to be sorted is empty.
421 * value compares neither less than, greater than, nor equal to any value,
430 * quicksorts to degrade to quadratic performance, and is typically
433 * @param a the array to be sorted
434 * @param fromIndex the index of the first element, inclusive, to be sorted
435 * @param toIndex the index of the last element, exclusive, to be sorted
457 * {@link ForkJoinPool#commonPool() ForkJoin common pool} is used to
460 * @param a the array to be sorted
478 * The range to be sorted extends from the index {@code fromIndex},
479 * inclusive, to the index {@code toIndex}, exclusive. If
480 * {@code fromIndex == toIndex}, the range to be sorted is empty.
491 * used to execute any parallel tasks.
493 * @param a the array to be sorted
494 * @param fromIndex the index of the first element, inclusive, to be sorted
495 * @param toIndex the index of the last element, exclusive, to be sorted
527 * {@link ForkJoinPool#commonPool() ForkJoin common pool} is used to
530 * @param a the array to be sorted
548 * The range to be sorted extends from the index {@code fromIndex},
549 * inclusive, to the index {@code toIndex}, exclusive. If
550 * {@code fromIndex == toIndex}, the range to be sorted is empty.
561 * used to execute any parallel tasks.
563 * @param a the array to be sorted
564 * @param fromIndex the index of the first element, inclusive, to be sorted
565 * @param toIndex the index of the last element, exclusive, to be sorted
597 * {@link ForkJoinPool#commonPool() ForkJoin common pool} is used to
600 * @param a the array to be sorted
618 * The range to be sorted extends from the index {@code fromIndex},
619 * inclusive, to the index {@code toIndex}, exclusive. If
620 * {@code fromIndex == toIndex}, the range to be sorted is empty.
631 * used to execute any parallel tasks.
633 * @param a the array to be sorted
634 * @param fromIndex the index of the first element, inclusive, to be sorted
635 * @param toIndex the index of the last element, exclusive, to be sorted
667 * {@link ForkJoinPool#commonPool() ForkJoin common pool} is used to
670 * @param a the array to be sorted
688 * The range to be sorted extends from the index {@code fromIndex},
689 * inclusive, to the index {@code toIndex}, exclusive. If
690 * {@code fromIndex == toIndex}, the range to be sorted is empty.
701 * used to execute any parallel tasks.
703 * @param a the array to be sorted
704 * @param fromIndex the index of the first element, inclusive, to be sorted
705 * @param toIndex the index of the last element, exclusive, to be sorted
737 * {@link ForkJoinPool#commonPool() ForkJoin common pool} is used to
740 * @param a the array to be sorted
758 * The range to be sorted extends from the index {@code fromIndex},
759 * inclusive, to the index {@code toIndex}, exclusive. If
760 * {@code fromIndex == toIndex}, the range to be sorted is empty.
771 * used to execute any parallel tasks.
773 * @param a the array to be sorted
774 * @param fromIndex the index of the first element, inclusive, to be sorted
775 * @param toIndex the index of the last element, exclusive, to be sorted
801 * value compares neither less than, greater than, nor equal to any value,
815 * {@link ForkJoinPool#commonPool() ForkJoin common pool} is used to
818 * @param a the array to be sorted
836 * The range to be sorted extends from the index {@code fromIndex},
837 * inclusive, to the index {@code toIndex}, exclusive. If
838 * {@code fromIndex == toIndex}, the range to be sorted is empty.
842 * value compares neither less than, greater than, nor equal to any value,
857 * used to execute any parallel tasks.
859 * @param a the array to be sorted
860 * @param fromIndex the index of the first element, inclusive, to be sorted
861 * @param toIndex the index of the last element, exclusive, to be sorted
887 * value compares neither less than, greater than, nor equal to any value,
901 * {@link ForkJoinPool#commonPool() ForkJoin common pool} is used to
904 * @param a the array to be sorted
922 * The range to be sorted extends from the index {@code fromIndex},
923 * inclusive, to the index {@code toIndex}, exclusive. If
924 * {@code fromIndex == toIndex}, the range to be sorted is empty.
928 * value compares neither less than, greater than, nor equal to any value,
943 * used to execute any parallel tasks.
945 * @param a the array to be sorted
946 * @param fromIndex the index of the first element, inclusive, to be sorted
947 * @param toIndex the index of the last element, exclusive, to be sorted
970 * to the {@linkplain Comparable natural ordering} of its elements.
977 * <p>This sort is guaranteed to be <i>stable</i>: equal elements will
988 * {@link ForkJoinPool#commonPool() ForkJoin common pool} is used to
991 * @param <T> the class of the objects to be sorted
992 * @param a the array to be sorted
997 * ordering of the array elements is found to violate the
1018 * ascending order, according to the
1020 * elements. The range to be sorted extends from index
1021 * {@code fromIndex}, inclusive, to index {@code toIndex}, exclusive.
1022 * (If {@code fromIndex==toIndex}, the range to be sorted is empty.) All
1029 * <p>This sort is guaranteed to be <i>stable</i>: equal elements will
1041 * used to execute any parallel tasks.
1043 * @param <T> the class of the objects to be sorted
1044 * @param a the array to be sorted
1045 * @param fromIndex the index of the first element (inclusive) to be
1047 * @param toIndex the index of the last element (exclusive) to be sorted
1050 * found to violate the {@link Comparable} contract
1076 * Sorts the specified array of objects according to the order induced by
1082 * <p>This sort is guaranteed to be <i>stable</i>: equal elements will
1093 * {@link ForkJoinPool#commonPool() ForkJoin common pool} is used to
1096 * @param <T> the class of the objects to be sorted
1097 * @param a the array to be sorted
1098 * @param cmp the comparator to determine the order of the array. A
1104 * found to violate the {@link java.util.Comparator} contract
1126 * to the order induced by the specified comparator. The range to be
1127 * sorted extends from index {@code fromIndex}, inclusive, to index
1129 * range to be sorted is empty.) All elements in the range must be
1134 * <p>This sort is guaranteed to be <i>stable</i>: equal elements will
1146 * used to execute any parallel tasks.
1148 * @param <T> the class of the objects to be sorted
1149 * @param a the array to be sorted
1150 * @param fromIndex the index of the first element (inclusive) to be
1152 * @param toIndex the index of the last element (exclusive) to be sorted
1153 * @param cmp the comparator to determine the order of the array. A
1158 * found to violate the {@link Comparable} contract
1192 * Cannot be a static boolean in the enclosing class due to
1204 * to the {@linkplain Comparable natural ordering} of its elements.
1211 * <p>This sort is guaranteed to be <i>stable</i>: equal elements will
1221 * input arrays to n/2 object references for randomly ordered input
1227 * input array. It is well-suited to merging two or more sorted arrays:
1237 * @param a the array to be sorted
1241 * ordering of the array elements is found to violate the
1259 * ascending order, according to the
1261 * elements. The range to be sorted extends from index
1262 * {@code fromIndex}, inclusive, to index {@code toIndex}, exclusive.
1263 * (If {@code fromIndex==toIndex}, the range to be sorted is empty.) All
1270 * <p>This sort is guaranteed to be <i>stable</i>: equal elements will
1280 * input arrays to n/2 object references for randomly ordered input
1286 * input array. It is well-suited to merging two or more sorted arrays:
1296 * @param a the array to be sorted
1297 * @param fromIndex the index of the first element (inclusive) to be
1299 * @param toIndex the index of the last element (exclusive) to be sorted
1302 * found to violate the {@link Comparable} contract
1326 * used in preference to mergesort.
1334 * low is the index in dest to start sorting
1335 * high is the end index in dest to end sorting
1336 * off is the offset to generate corresponding low, high in src
1365 // If list is already sorted, just copy from src to dest. This is an
1391 * Sorts the specified array of objects according to the order induced by
1397 * <p>This sort is guaranteed to be <i>stable</i>: equal elements will
1407 * input arrays to n/2 object references for randomly ordered input
1413 * input array. It is well-suited to merging two or more sorted arrays:
1423 * @param <T> the class of the objects to be sorted
1424 * @param a the array to be sorted
1425 * @param c the comparator to determine the order of the array. A
1431 * found to violate the {@link Comparator} contract
1455 * to the order induced by the specified comparator. The range to be
1456 * sorted extends from index {@code fromIndex}, inclusive, to index
1458 * range to be sorted is empty.) All elements in the range must be
1463 * <p>This sort is guaranteed to be <i>stable</i>: equal elements will
1473 * input arrays to n/2 object references for randomly ordered input
1479 * input array. It is well-suited to merging two or more sorted arrays:
1489 * @param <T> the class of the objects to be sorted
1490 * @param a the array to be sorted
1491 * @param fromIndex the index of the first element (inclusive) to be
1493 * @param toIndex the index of the last element (exclusive) to be sorted
1494 * @param c the comparator to determine the order of the array. A
1500 * (optional) if the comparator is found to violate the
1531 * low is the index in dest to start sorting
1532 * high is the end index in dest to end sorting
1533 * off is the offset into src corresponding to low in dest
1560 // If list is already sorted, just copy from src to dest. This is an
1588 * @param op a side-effect-free, associative function to perform the
1608 * @param op a side-effect-free, associative function to perform the
1634 * @param op a side-effect-free, associative function to perform the
1653 * @param op a side-effect-free, associative function to perform the
1679 * the returned result may not be identical to the value that would be
1683 * @param op a side-effect-free function to perform the cumulation
1701 * @param op a side-effect-free, associative function to perform the
1727 * @param op a side-effect-free, associative function to perform the
1746 * @param op a side-effect-free, associative function to perform the
1768 * by the {@link #sort(long[])} method) prior to making this call. If it
1773 * @param a the array to be searched
1774 * @param key the value to be searched for
1794 * prior to making this call. If it
1799 * @param a the array to be searched
1800 * @param fromIndex the index of the first element (inclusive) to be
1802 * @param toIndex the index of the last element (exclusive) to be searched
1803 * @param key the value to be searched for
1849 * by the {@link #sort(int[])} method) prior to making this call. If it
1854 * @param a the array to be searched
1855 * @param key the value to be searched for
1875 * prior to making this call. If it
1880 * @param a the array to be searched
1881 * @param fromIndex the index of the first element (inclusive) to be
1883 * @param toIndex the index of the last element (exclusive) to be searched
1884 * @param key the value to be searched for
1930 * (as by the {@link #sort(short[])} method) prior to making this call. If
1935 * @param a the array to be searched
1936 * @param key the value to be searched for
1956 * prior to making this call. If
1961 * @param a the array to be searched
1962 * @param fromIndex the index of the first element (inclusive) to be
1964 * @param toIndex the index of the last element (exclusive) to be searched
1965 * @param key the value to be searched for
2011 * by the {@link #sort(char[])} method) prior to making this call. If it
2016 * @param a the array to be searched
2017 * @param key the value to be searched for
2037 * prior to making this call. If it
2042 * @param a the array to be searched
2043 * @param fromIndex the index of the first element (inclusive) to be
2045 * @param toIndex the index of the last element (exclusive) to be searched
2046 * @param key the value to be searched for
2092 * by the {@link #sort(byte[])} method) prior to making this call. If it
2097 * @param a the array to be searched
2098 * @param key the value to be searched for
2118 * prior to making this call. If it
2123 * @param a the array to be searched
2124 * @param fromIndex the index of the first element (inclusive) to be
2126 * @param toIndex the index of the last element (exclusive) to be searched
2127 * @param key the value to be searched for
2173 * (as by the {@link #sort(double[])} method) prior to making this call.
2176 * one will be found. This method considers all NaN values to be
2179 * @param a the array to be searched
2180 * @param key the value to be searched for
2200 * prior to making this call.
2203 * one will be found. This method considers all NaN values to be
2206 * @param a the array to be searched
2207 * @param fromIndex the index of the first element (inclusive) to be
2209 * @param toIndex the index of the last element (exclusive) to be searched
2210 * @param key the value to be searched for
2264 * (as by the {@link #sort(float[])} method) prior to making this call. If
2267 * one will be found. This method considers all NaN values to be
2270 * @param a the array to be searched
2271 * @param key the value to be searched for
2291 * prior to making this call. If
2294 * one will be found. This method considers all NaN values to be
2297 * @param a the array to be searched
2298 * @param fromIndex the index of the first element (inclusive) to be
2300 * @param toIndex the index of the last element (exclusive) to be searched
2301 * @param key the value to be searched for
2355 * according to the
2358 * {@link #sort(Object[])} method) prior to making this call.
2362 * to the natural ordering of its elements, hence results are undefined.)
2364 * elements equal to the specified object, there is no guarantee which
2367 * @param a the array to be searched
2368 * @param key the value to be searched for
2377 * @throws ClassCastException if the search key is not comparable to the
2389 * according to the
2392 * {@link #sort(Object[], int, int)} method) prior to making this
2396 * to the natural ordering of its elements, hence results are undefined.)
2398 * elements equal to the specified object, there is no guarantee which
2401 * @param a the array to be searched
2402 * @param fromIndex the index of the first element (inclusive) to be
2404 * @param toIndex the index of the last element (exclusive) to be searched
2405 * @param key the value to be searched for
2416 * @throws ClassCastException if the search key is not comparable to the
2456 * according to the specified comparator (as by the
2458 * method) prior to making this call. If it is
2461 * elements equal to the specified object, there is no guarantee which one
2465 * @param a the array to be searched
2466 * @param key the value to be searched for
2480 * or the search key is not comparable to the
2492 * according to the specified comparator (as by the
2495 * method) prior to making this call.
2497 * If the range contains multiple elements equal to the specified object,
2501 * @param a the array to be searched
2502 * @param fromIndex the index of the first element (inclusive) to be
2504 * @param toIndex the index of the last element (exclusive) to be searched
2505 * @param key the value to be searched for
2521 * or the search key is not comparable to the
2562 * <i>equal</i> to one another. Two arrays are considered equal if both
2568 * @param a one array to be tested for equality
2569 * @param a2 the other array to be tested for equality
2587 * ranges, are <i>equal</i> to one another.
2595 * @param a the first array to be tested for equality
2597 * first array to be tested
2599 * first array to be tested
2600 * @param b the second array to be tested fro equality
2602 * second array to be tested
2604 * second array to be tested
2634 * <i>equal</i> to one another. Two arrays are considered equal if both
2640 * @param a one array to be tested for equality
2641 * @param a2 the other array to be tested for equality
2659 * ranges, are <i>equal</i> to one another.
2667 * @param a the first array to be tested for equality
2669 * first array to be tested
2671 * first array to be tested
2672 * @param b the second array to be tested fro equality
2674 * second array to be tested
2676 * second array to be tested
2706 * <i>equal</i> to one another. Two arrays are considered equal if both
2712 * @param a one array to be tested for equality
2713 * @param a2 the other array to be tested for equality
2731 * ranges, are <i>equal</i> to one another.
2739 * @param a the first array to be tested for equality
2741 * first array to be tested
2743 * first array to be tested
2744 * @param b the second array to be tested fro equality
2746 * second array to be tested
2748 * second array to be tested
2778 * <i>equal</i> to one another. Two arrays are considered equal if both
2784 * @param a one array to be tested for equality
2785 * @param a2 the other array to be tested for equality
2804 * ranges, are <i>equal</i> to one another.
2812 * @param a the first array to be tested for equality
2814 * first array to be tested
2816 * first array to be tested
2817 * @param b the second array to be tested fro equality
2819 * second array to be tested
2821 * second array to be tested
2851 * <i>equal</i> to one another. Two arrays are considered equal if both
2857 * @param a one array to be tested for equality
2858 * @param a2 the other array to be tested for equality
2877 * ranges, are <i>equal</i> to one another.
2885 * @param a the first array to be tested for equality
2887 * first array to be tested
2889 * first array to be tested
2890 * @param b the second array to be tested fro equality
2892 * second array to be tested
2894 * second array to be tested
2924 * <i>equal</i> to one another. Two arrays are considered equal if both
2930 * @param a one array to be tested for equality
2931 * @param a2 the other array to be tested for equality
2949 * ranges, are <i>equal</i> to one another.
2957 * @param a the first array to be tested for equality
2959 * first array to be tested
2961 * first array to be tested
2962 * @param b the second array to be tested fro equality
2964 * second array to be tested
2966 * second array to be tested
2996 * <i>equal</i> to one another. Two arrays are considered equal if both
3005 * {@code NaN} equals to itself, and 0.0d unequal to -0.0d.)
3007 * @param a one array to be tested for equality
3008 * @param a2 the other array to be tested for equality
3027 * ranges, are <i>equal</i> to one another.
3038 * {@code NaN} equals to itself, and 0.0d unequal to -0.0d.)
3040 * @param a the first array to be tested for equality
3042 * first array to be tested
3044 * first array to be tested
3045 * @param b the second array to be tested fro equality
3047 * second array to be tested
3049 * second array to be tested
3079 * <i>equal</i> to one another. Two arrays are considered equal if both
3088 * {@code NaN} equals to itself, and 0.0f unequal to -0.0f.)
3090 * @param a one array to be tested for equality
3091 * @param a2 the other array to be tested for equality
3110 * ranges, are <i>equal</i> to one another.
3121 * {@code NaN} equals to itself, and 0.0f unequal to -0.0f.)
3123 * @param a the first array to be tested for equality
3125 * first array to be tested
3127 * first array to be tested
3128 * @param b the second array to be tested fro equality
3130 * second array to be tested
3132 * second array to be tested
3162 * <i>equal</i> to one another. The two arrays are considered equal if
3171 * @param a one array to be tested for equality
3172 * @param a2 the other array to be tested for equality
3195 * ranges, are <i>equal</i> to one another.
3206 * @param a the first array to be tested for equality
3208 * first array to be tested
3210 * first array to be tested
3211 * @param b the second array to be tested fro equality
3213 * second array to be tested
3215 * second array to be tested
3248 * <i>equal</i> to one another.
3259 * @param a one array to be tested for equality
3260 * @param a2 the other array to be tested for equality
3261 * @param cmp the comparator to compare array elements
3288 * ranges, are <i>equal</i> to one another.
3299 * @param a the first array to be tested for equality
3301 * first array to be tested
3303 * first array to be tested
3304 * @param b the second array to be tested fro equality
3306 * second array to be tested
3308 * second array to be tested
3309 * @param cmp the comparator to compare array elements
3346 * Assigns the specified long value to each element of the specified array
3349 * @param a the array to be filled
3350 * @param val the value to be stored in all elements of the array
3358 * Assigns the specified long value to each element of the specified
3359 * range of the specified array of longs. The range to be filled
3360 * extends from index {@code fromIndex}, inclusive, to index
3362 * range to be filled is empty.)
3364 * @param a the array to be filled
3365 * @param fromIndex the index of the first element (inclusive) to be
3367 * @param toIndex the index of the last element (exclusive) to be
3369 * @param val the value to be stored in all elements of the array
3381 * Assigns the specified int value to each element of the specified array
3384 * @param a the array to be filled
3385 * @param val the value to be stored in all elements of the array
3393 * Assigns the specified int value to each element of the specified
3394 * range of the specified array of ints. The range to be filled
3395 * extends from index {@code fromIndex}, inclusive, to index
3397 * range to be filled is empty.)
3399 * @param a the array to be filled
3400 * @param fromIndex the index of the first element (inclusive) to be
3402 * @param toIndex the index of the last element (exclusive) to be
3404 * @param val the value to be stored in all elements of the array
3416 * Assigns the specified short value to each element of the specified array
3419 * @param a the array to be filled
3420 * @param val the value to be stored in all elements of the array
3428 * Assigns the specified short value to each element of the specified
3429 * range of the specified array of shorts. The range to be filled
3430 * extends from index {@code fromIndex}, inclusive, to index
3432 * range to be filled is empty.)
3434 * @param a the array to be filled
3435 * @param fromIndex the index of the first element (inclusive) to be
3437 * @param toIndex the index of the last element (exclusive) to be
3439 * @param val the value to be stored in all elements of the array
3451 * Assigns the specified char value to each element of the specified array
3454 * @param a the array to be filled
3455 * @param val the value to be stored in all elements of the array
3463 * Assigns the specified char value to each element of the specified
3464 * range of the specified array of chars. The range to be filled
3465 * extends from index {@code fromIndex}, inclusive, to index
3467 * range to be filled is empty.)
3469 * @param a the array to be filled
3470 * @param fromIndex the index of the first element (inclusive) to be
3472 * @param toIndex the index of the last element (exclusive) to be
3474 * @param val the value to be stored in all elements of the array
3486 * Assigns the specified byte value to each element of the specified array
3489 * @param a the array to be filled
3490 * @param val the value to be stored in all elements of the array
3498 * Assigns the specified byte value to each element of the specified
3499 * range of the specified array of bytes. The range to be filled
3500 * extends from index {@code fromIndex}, inclusive, to index
3502 * range to be filled is empty.)
3504 * @param a the array to be filled
3505 * @param fromIndex the index of the first element (inclusive) to be
3507 * @param toIndex the index of the last element (exclusive) to be
3509 * @param val the value to be stored in all elements of the array
3521 * Assigns the specified boolean value to each element of the specified
3524 * @param a the array to be filled
3525 * @param val the value to be stored in all elements of the array
3533 * Assigns the specified boolean value to each element of the specified
3534 * range of the specified array of booleans. The range to be filled
3535 * extends from index {@code fromIndex}, inclusive, to index
3537 * range to be filled is empty.)
3539 * @param a the array to be filled
3540 * @param fromIndex the index of the first element (inclusive) to be
3542 * @param toIndex the index of the last element (exclusive) to be
3544 * @param val the value to be stored in all elements of the array
3557 * Assigns the specified double value to each element of the specified
3560 * @param a the array to be filled
3561 * @param val the value to be stored in all elements of the array
3569 * Assigns the specified double value to each element of the specified
3570 * range of the specified array of doubles. The range to be filled
3571 * extends from index {@code fromIndex}, inclusive, to index
3573 * range to be filled is empty.)
3575 * @param a the array to be filled
3576 * @param fromIndex the index of the first element (inclusive) to be
3578 * @param toIndex the index of the last element (exclusive) to be
3580 * @param val the value to be stored in all elements of the array
3592 * Assigns the specified float value to each element of the specified array
3595 * @param a the array to be filled
3596 * @param val the value to be stored in all elements of the array
3604 * Assigns the specified float value to each element of the specified
3605 * range of the specified array of floats. The range to be filled
3606 * extends from index {@code fromIndex}, inclusive, to index
3608 * range to be filled is empty.)
3610 * @param a the array to be filled
3611 * @param fromIndex the index of the first element (inclusive) to be
3613 * @param toIndex the index of the last element (exclusive) to be
3615 * @param val the value to be stored in all elements of the array
3627 * Assigns the specified Object reference to each element of the specified
3630 * @param a the array to be filled
3631 * @param val the value to be stored in all elements of the array
3641 * Assigns the specified Object reference to each element of the specified
3642 * range of the specified array of Objects. The range to be filled
3643 * extends from index {@code fromIndex}, inclusive, to index
3645 * range to be filled is empty.)
3647 * @param a the array to be filled
3648 * @param fromIndex the index of the first element (inclusive) to be
3650 * @param toIndex the index of the last element (exclusive) to be
3652 * @param val the value to be stored in all elements of the array
3678 * @param original the array to be copied
3679 * @param newLength the length of the copy to be returned
3681 * to obtain the specified length
3703 * @param original the array to be copied
3704 * @param newLength the length of the copy to be returned
3705 * @param newType the class of the copy to be returned
3707 * to obtain the specified length
3735 * @param original the array to be copied
3736 * @param newLength the length of the copy to be returned
3738 * to obtain the specified length
3759 * @param original the array to be copied
3760 * @param newLength the length of the copy to be returned
3762 * to obtain the specified length
3783 * @param original the array to be copied
3784 * @param newLength the length of the copy to be returned
3786 * to obtain the specified length
3807 * @param original the array to be copied
3808 * @param newLength the length of the copy to be returned
3810 * to obtain the specified length
3831 * @param original the array to be copied
3832 * @param newLength the length of the copy to be returned
3834 * to obtain the specified length
3855 * @param original the array to be copied
3856 * @param newLength the length of the copy to be returned
3858 * to obtain the specified length
3879 * @param original the array to be copied
3880 * @param newLength the length of the copy to be returned
3882 * to obtain the specified length
3903 * @param original the array to be copied
3904 * @param newLength the length of the copy to be returned
3906 * to obtain the specified length
3923 * (unless {@code from == original.length} or {@code from == to}).
3926 * ({@code to}), which must be greater than or equal to {@code from},
3929 * greater than or equal to {@code original.length - from}. The length
3930 * of the returned array will be {@code to - from}.
3935 * @param original the array from which a range is to be copied
3936 * @param from the initial index of the range to be copied, inclusive
3937 * @param to the final index of the range to be copied, exclusive.
3940 * truncated or padded with nulls to obtain the required length
3943 * @throws IllegalArgumentException if {@code from > to}
3948 public static <T> T[] copyOfRange(T[] original, int from, int to) {
3949 return copyOfRange(original, from, to, (Class<? extends T[]>) original.getClass());
3957 * (unless {@code from == original.length} or {@code from == to}).
3960 * ({@code to}), which must be greater than or equal to {@code from},
3963 * greater than or equal to {@code original.length - from}. The length
3964 * of the returned array will be {@code to - from}.
3969 * @param original the array from which a range is to be copied
3970 * @param from the initial index of the range to be copied, inclusive
3971 * @param to the final index of the range to be copied, exclusive.
3973 * @param newType the class of the copy to be returned
3975 * truncated or padded with nulls to obtain the required length
3978 * @throws IllegalArgumentException if {@code from > to}
3986 public static <T,U> T[] copyOfRange(U[] original, int from, int to, Class<? extends T[]> newType) {
3987 int newLength = to - from;
3989 throw new IllegalArgumentException(from + " > " + to);
4004 * (unless {@code from == original.length} or {@code from == to}).
4007 * ({@code to}), which must be greater than or equal to {@code from},
4010 * greater than or equal to {@code original.length - from}. The length
4011 * of the returned array will be {@code to - from}.
4013 * @param original the array from which a range is to be copied
4014 * @param from the initial index of the range to be copied, inclusive
4015 * @param to the final index of the range to be copied, exclusive.
4018 * truncated or padded with zeros to obtain the required length
4021 * @throws IllegalArgumentException if {@code from > to}
4025 public static byte[] copyOfRange(byte[] original, int from, int to) {
4026 int newLength = to - from;
4028 throw new IllegalArgumentException(from + " > " + to);
4040 * (unless {@code from == original.length} or {@code from == to}).
4043 * ({@code to}), which must be greater than or equal to {@code from},
4046 * greater than or equal to {@code original.length - from}. The length
4047 * of the returned array will be {@code to - from}.
4049 * @param original the array from which a range is to be copied
4050 * @param from the initial index of the range to be copied, inclusive
4051 * @param to the final index of the range to be copied, exclusive.
4054 * truncated or padded with zeros to obtain the required length
4057 * @throws IllegalArgumentException if {@code from > to}
4061 public static short[] copyOfRange(short[] original, int from, int to) {
4062 int newLength = to - from;
4064 throw new IllegalArgumentException(from + " > " + to);
4076 * (unless {@code from == original.length} or {@code from == to}).
4079 * ({@code to}), which must be greater than or equal to {@code from},
4082 * greater than or equal to {@code original.length - from}. The length
4083 * of the returned array will be {@code to - from}.
4085 * @param original the array from which a range is to be copied
4086 * @param from the initial index of the range to be copied, inclusive
4087 * @param to the final index of the range to be copied, exclusive.
4090 * truncated or padded with zeros to obtain the required length
4093 * @throws IllegalArgumentException if {@code from > to}
4097 public static int[] copyOfRange(int[] original, int from, int to) {
4098 int newLength = to - from;
4100 throw new IllegalArgumentException(from + " > " + to);
4112 * (unless {@code from == original.length} or {@code from == to}).
4115 * ({@code to}), which must be greater than or equal to {@code from},
4118 * greater than or equal to {@code original.length - from}. The length
4119 * of the returned array will be {@code to - from}.
4121 * @param original the array from which a range is to be copied
4122 * @param from the initial index of the range to be copied, inclusive
4123 * @param to the final index of the range to be copied, exclusive.
4126 * truncated or padded with zeros to obtain the required length
4129 * @throws IllegalArgumentException if {@code from > to}
4133 public static long[] copyOfRange(long[] original, int from, int to) {
4134 int newLength = to - from;
4136 throw new IllegalArgumentException(from + " > " + to);
4148 * (unless {@code from == original.length} or {@code from == to}).
4151 * ({@code to}), which must be greater than or equal to {@code from},
4154 * greater than or equal to {@code original.length - from}. The length
4155 * of the returned array will be {@code to - from}.
4157 * @param original the array from which a range is to be copied
4158 * @param from the initial index of the range to be copied, inclusive
4159 * @param to the final index of the range to be copied, exclusive.
4162 * truncated or padded with null characters to obtain the required length
4165 * @throws IllegalArgumentException if {@code from > to}
4169 public static char[] copyOfRange(char[] original, int from, int to) {
4170 int newLength = to - from;
4172 throw new IllegalArgumentException(from + " > " + to);
4184 * (unless {@code from == original.length} or {@code from == to}).
4187 * ({@code to}), which must be greater than or equal to {@code from},
4190 * greater than or equal to {@code original.length - from}. The length
4191 * of the returned array will be {@code to - from}.
4193 * @param original the array from which a range is to be copied
4194 * @param from the initial index of the range to be copied, inclusive
4195 * @param to the final index of the range to be copied, exclusive.
4198 * truncated or padded with zeros to obtain the required length
4201 * @throws IllegalArgumentException if {@code from > to}
4205 public static float[] copyOfRange(float[] original, int from, int to) {
4206 int newLength = to - from;
4208 throw new IllegalArgumentException(from + " > " + to);
4220 * (unless {@code from == original.length} or {@code from == to}).
4223 * ({@code to}), which must be greater than or equal to {@code from},
4226 * greater than or equal to {@code original.length - from}. The length
4227 * of the returned array will be {@code to - from}.
4229 * @param original the array from which a range is to be copied
4230 * @param from the initial index of the range to be copied, inclusive
4231 * @param to the final index of the range to be copied, exclusive.
4234 * truncated or padded with zeros to obtain the required length
4237 * @throws IllegalArgumentException if {@code from > to}
4241 public static double[] copyOfRange(double[] original, int from, int to) {
4242 int newLength = to - from;
4244 throw new IllegalArgumentException(from + " > " + to);
4256 * (unless {@code from == original.length} or {@code from == to}).
4259 * ({@code to}), which must be greater than or equal to {@code from},
4262 * greater than or equal to {@code original.length - from}. The length
4263 * of the returned array will be {@code to - from}.
4265 * @param original the array from which a range is to be copied
4266 * @param from the initial index of the range to be copied, inclusive
4267 * @param to the final index of the range to be copied, exclusive.
4270 * truncated or padded with false elements to obtain the required length
4273 * @throws IllegalArgumentException if {@code from > to}
4277 public static boolean[] copyOfRange(boolean[] original, int from, int to) {
4278 int newLength = to - from;
4280 throw new IllegalArgumentException(from + " > " + to);
4290 * Returns a fixed-size list backed by the specified array. (Changes to
4291 * the returned list "write through" to the array.) This method acts
4296 * <p>This method also provides a convenient way to create a fixed-size
4297 * list initialized to contain several elements:
4449 * @param a the array whose hash value to compute
4478 * @param a the array whose hash value to compute
4505 * @param a the array whose hash value to compute
4532 * @param a the array whose hash value to compute
4559 * @param a the array whose hash value to compute
4586 * @param a the array whose hash value to compute
4613 * @param a the array whose hash value to compute
4640 * @param a the array whose hash value to compute
4660 * acceptable to invoke this method on an array that contains itself as an
4668 * <p>The value returned by this method is equal to the value that would
4672 * @param a the array whose content-based hash code to compute
4693 * It is therefore unacceptable to invoke this method on an array that
4702 * <p>The computation of the value returned by this method is similar to
4713 * @param a the array whose deep-content-based hash code to compute
4755 * equal</i> to one another. Unlike the {@link #equals(Object[],Object[])}
4760 * are {@code null}, or if they refer to arrays that contain the same
4781 * @param a1 one array to be tested for equality
4782 * @param a2 the other array to be tested for equality
4846 * space). Elements are converted to strings as by
4850 * @param a the array whose string representation to return
4876 * space). Elements are converted to strings as by
4880 * @param a the array whose string representation to return
4906 * space). Elements are converted to strings as by
4910 * @param a the array whose string representation to return
4936 * space). Elements are converted to strings as by
4940 * @param a the array whose string representation to return
4966 * by a space). Elements are converted to strings as by
4970 * @param a the array whose string representation to return
4996 * space). Elements are converted to strings as by
5000 * @param a the array whose string representation to return
5026 * space). Elements are converted to strings as by
5030 * @param a the array whose string representation to return
5057 * space). Elements are converted to strings as by
5061 * @param a the array whose string representation to return
5084 * If the array contains other arrays as elements, they are converted to
5089 * <p>The value returned by this method is equal to the value that would
5093 * @param a the array whose string representation to return
5120 * designed for converting multidimensional arrays to strings.
5125 * followed by a space). Elements are converted to strings as by
5130 * converted to a string as by invoking the appropriate overloading of
5132 * reference type, it is converted to a string as by invoking
5136 * as an element, or contains an indirect reference to itself through one
5137 * or more levels of arrays, the self-reference is converted to the string
5139 * to itself would be rendered as {@code "[[...]]"}.
5144 * @param a the array whose string representation to return
5221 * generator function to compute each element.
5223 * <p>If the generator function throws an exception, it is relayed to
5227 * Setting a subrange of an array, using a generator function to compute
5235 * @param array array to be initialized
5249 * provided generator function to compute each element.
5257 * to compute each element, can be written as follows:
5265 * @param array array to be initialized
5278 * generator function to compute each element.
5280 * <p>If the generator function throws an exception, it is relayed to
5284 * Setting a subrange of an array, using a generator function to compute
5291 * @param array array to be initialized
5305 * provided generator function to compute each element.
5313 * to compute each element, can be written as follows:
5320 * @param array array to be initialized
5333 * generator function to compute each element.
5335 * <p>If the generator function throws an exception, it is relayed to
5339 * Setting a subrange of an array, using a generator function to compute
5346 * @param array array to be initialized
5360 * provided generator function to compute each element.
5368 * to compute each element, can be written as follows:
5375 * @param array array to be initialized
5388 * generator function to compute each element.
5390 * <p>If the generator function throws an exception, it is relayed to
5394 * Setting a subrange of an array, using a generator function to compute
5401 * @param array array to be initialized
5415 * provided generator function to compute each element.
5423 * to compute each element, can be written as follows:
5430 * @param array array to be initialized
5449 * @param array the array, assumed to be unmodified during use
5467 * @param array the array, assumed to be unmodified during use
5468 * @param startInclusive the first index to cover, inclusive
5469 * @param endExclusive index immediately past the last index to cover
5489 * @param array the array, assumed to be unmodified during use
5506 * @param array the array, assumed to be unmodified during use
5507 * @param startInclusive the first index to cover, inclusive
5508 * @param endExclusive index immediately past the last index to cover
5528 * @param array the array, assumed to be unmodified during use
5545 * @param array the array, assumed to be unmodified during use
5546 * @param startInclusive the first index to cover, inclusive
5547 * @param endExclusive index immediately past the last index to cover
5568 * @param array the array, assumed to be unmodified during use
5585 * @param array the array, assumed to be unmodified during use
5586 * @param startInclusive the first index to cover, inclusive
5587 * @param endExclusive index immediately past the last index to cover
5605 * @param array The array, assumed to be unmodified during use
5618 * @param array the array, assumed to be unmodified during use
5619 * @param startInclusive the first index to cover, inclusive
5620 * @param endExclusive index immediately past the last index to cover
5636 * @param array the array, assumed to be unmodified during use
5648 * @param array the array, assumed to be unmodified during use
5649 * @param startInclusive the first index to cover, inclusive
5650 * @param endExclusive index immediately past the last index to cover
5666 * @param array the array, assumed to be unmodified during use
5678 * @param array the array, assumed to be unmodified during use
5679 * @param startInclusive the first index to cover, inclusive
5680 * @param endExclusive index immediately past the last index to cover
5696 * @param array the array, assumed to be unmodified during use
5708 * @param array the array, assumed to be unmodified during use
5709 * @param startInclusive the first index to cover, inclusive
5710 * @param endExclusive index immediately past the last index to cover
5758 * @param a the first array to compare
5759 * @param b the second array to compare
5817 * @param a the first array to compare
5819 * first array to be compared
5821 * first array to be compared
5822 * @param b the second array to compare
5824 * second array to be compared
5826 * second array to be compared
5894 * @param a the first array to compare
5895 * @param b the second array to compare
5952 * @param a the first array to compare
5954 * first array to be compared
5956 * first array to be compared
5957 * @param b the second array to compare
5959 * second array to be compared
5961 * second array to be compared
6022 * @param a the first array to compare
6023 * @param b the second array to compare
6072 * @param a the first array to compare
6074 * first array to be compared
6076 * first array to be compared
6077 * @param b the second array to compare
6079 * second array to be compared
6081 * second array to be compared
6149 * @param a the first array to compare
6150 * @param b the second array to compare
6207 * @param a the first array to compare
6209 * first array to be compared
6211 * first array to be compared
6212 * @param b the second array to compare
6214 * second array to be compared
6216 * second array to be compared
6277 * @param a the first array to compare
6278 * @param b the second array to compare
6326 * @param a the first array to compare
6328 * first array to be compared
6330 * first array to be compared
6331 * @param b the second array to compare
6333 * second array to be compared
6335 * second array to be compared
6403 * @param a the first array to compare
6404 * @param b the second array to compare
6461 * @param a the first array to compare
6463 * first array to be compared
6465 * first array to be compared
6466 * @param b the second array to compare
6468 * second array to be compared
6470 * second array to be compared
6538 * @param a the first array to compare
6539 * @param b the second array to compare
6596 * @param a the first array to compare
6598 * first array to be compared
6600 * first array to be compared
6601 * @param b the second array to compare
6603 * second array to be compared
6605 * second array to be compared
6666 * @param a the first array to compare
6667 * @param b the second array to compare
6715 * @param a the first array to compare
6717 * first array to be compared
6719 * first array to be compared
6720 * @param b the second array to compare
6722 * second array to be compared
6724 * second array to be compared
6792 * @param a the first array to compare
6793 * @param b the second array to compare
6850 * @param a the first array to compare
6852 * first array to be compared
6854 * first array to be compared
6855 * @param b the second array to compare
6857 * second array to be compared
6859 * second array to be compared
6920 * @param a the first array to compare
6921 * @param b the second array to compare
6969 * @param a the first array to compare
6971 * first array to be compared
6973 * first array to be compared
6974 * @param b the second array to compare
6976 * second array to be compared
6978 * second array to be compared
7046 * @param a the first array to compare
7047 * @param b the second array to compare
7104 * @param a the first array to compare
7106 * first array to be compared
7108 * first array to be compared
7109 * @param b the second array to compare
7111 * second array to be compared
7113 * second array to be compared
7181 * @param a the first array to compare
7182 * @param b the second array to compare
7239 * @param a the first array to compare
7241 * first array to be compared
7243 * first array to be compared
7244 * @param b the second array to compare
7246 * second array to be compared
7248 * second array to be compared
7325 * @param a the first array to compare
7326 * @param b the second array to compare
7398 * @param a the first array to compare
7400 * first array to be compared
7402 * first array to be compared
7403 * @param b the second array to compare
7405 * second array to be compared
7407 * second array to be compared
7477 * @param a the first array to compare
7478 * @param b the second array to compare
7479 * @param cmp the comparator to compare array elements
7503 // Null-value comparison is deferred to the comparator
7537 * @param a the first array to compare
7539 * first array to be compared
7541 * first array to be compared
7542 * @param b the second array to compare
7544 * second array to be compared
7546 * second array to be compared
7547 * @param cmp the comparator to compare array elements
7581 // Null-value comparison is deferred to the comparator
7600 * index will be in the range of 0 (inclusive) up to the length (inclusive)
7630 * @param a the first array to be tested for a mismatch
7631 * @param b the second array to be tested for a mismatch
7651 * to the length (inclusive) of the smaller range.
7686 * @param a the first array to be tested for a mismatch
7688 * first array to be tested
7690 * first array to be tested
7691 * @param b the second array to be tested for a mismatch
7693 * second array to be tested
7695 * second array to be tested
7727 * in the range of 0 (inclusive) up to the length (inclusive) of the smaller
7757 * @param a the first array to be tested for a mismatch
7758 * @param b the second array to be tested for a mismatch
7777 * mismatch is found. The index will be in the range of 0 (inclusive) up to
7813 * @param a the first array to be tested for a mismatch
7815 * first array to be tested
7817 * first array to be tested
7818 * @param b the second array to be tested for a mismatch
7820 * second array to be tested
7822 * second array to be tested
7854 * in the range of 0 (inclusive) up to the length (inclusive) of the smaller
7884 * @param a the first array to be tested for a mismatch
7885 * @param b the second array to be tested for a mismatch
7904 * mismatch is found. The index will be in the range of 0 (inclusive) up to
7940 * @param a the first array to be tested for a mismatch
7942 * first array to be tested
7944 * first array to be tested
7945 * @param b the second array to be tested for a mismatch
7947 * second array to be tested
7949 * second array to be tested
7981 * in the range of 0 (inclusive) up to the length (inclusive) of the smaller
8011 * @param a the first array to be tested for a mismatch
8012 * @param b the second array to be tested for a mismatch
8031 * mismatch is found. The index will be in the range of 0 (inclusive) up to
8067 * @param a the first array to be tested for a mismatch
8069 * first array to be tested
8071 * first array to be tested
8072 * @param b the second array to be tested for a mismatch
8074 * second array to be tested
8076 * second array to be tested
8108 * in the range of 0 (inclusive) up to the length (inclusive) of the smaller
8138 * @param a the first array to be tested for a mismatch
8139 * @param b the second array to be tested for a mismatch
8158 * mismatch is found. The index will be in the range of 0 (inclusive) up to
8194 * @param a the first array to be tested for a mismatch
8196 * first array to be tested
8198 * first array to be tested
8199 * @param b the second array to be tested for a mismatch
8201 * second array to be tested
8203 * second array to be tested
8235 * in the range of 0 (inclusive) up to the length (inclusive) of the smaller
8265 * @param a the first array to be tested for a mismatch
8266 * @param b the second array to be tested for a mismatch
8285 * mismatch is found. The index will be in the range of 0 (inclusive) up to
8321 * @param a the first array to be tested for a mismatch
8323 * first array to be tested
8325 * first array to be tested
8326 * @param b the second array to be tested for a mismatch
8328 * second array to be tested
8330 * second array to be tested
8362 * in the range of 0 (inclusive) up to the length (inclusive) of the smaller
8392 * @param a the first array to be tested for a mismatch
8393 * @param b the second array to be tested for a mismatch
8412 * mismatch is found. The index will be in the range of 0 (inclusive) up to
8448 * @param a the first array to be tested for a mismatch
8450 * first array to be tested
8452 * first array to be tested
8453 * @param b the second array to be tested for a mismatch
8455 * second array to be tested
8457 * second array to be tested
8489 * index will be in the range of 0 (inclusive) up to the length (inclusive)
8519 * @param a the first array to be tested for a mismatch
8520 * @param b the second array to be tested for a mismatch
8540 * to the length (inclusive) of the smaller range.
8575 * @param a the first array to be tested for a mismatch
8577 * first array to be tested
8579 * first array to be tested
8580 * @param b the second array to be tested for a mismatch
8582 * second array to be tested
8584 * second array to be tested
8616 * index will be in the range of 0 (inclusive) up to the length (inclusive)
8646 * @param a the first array to be tested for a mismatch
8647 * @param b the second array to be tested for a mismatch
8671 * to the length (inclusive) of the smaller range.
8706 * @param a the first array to be tested for a mismatch
8708 * first array to be tested
8710 * first array to be tested
8711 * @param b the second array to be tested for a mismatch
8713 * second array to be tested
8715 * second array to be tested
8748 * The index will be in the range of 0 (inclusive) up to the length
8751 * <p>The specified comparator is used to determine if two array elements
8782 * @param a the first array to be tested for a mismatch
8783 * @param b the second array to be tested for a mismatch
8784 * @param cmp the comparator to compare array elements
8802 // Null-value comparison is deferred to the comparator
8817 * to the length (inclusive) of the smaller range.
8853 * @param a the first array to be tested for a mismatch
8855 * first array to be tested
8857 * first array to be tested
8858 * @param b the second array to be tested for a mismatch
8860 * second array to be tested
8862 * second array to be tested
8863 * @param cmp the comparator to compare array elements
8892 // Null-value comparison is deferred to the comparator