Класс Arrays
public class Arrays extends Object
Методы в этом классе выбрасывают исключение NullPointerException, если указанная ссылка на массив равна null, за исключением случаев, где это указано.
Документация методов этого класса включает краткие описания реализаций. Такие описания следует рассматривать как примечания к реализации, а не части спецификации. Реализаторы могут свободно заменять другие алгоритмы, пока соблюдается сама спецификация. (Например, алгоритм, используемый sort(Object[]), не обязательно должен быть MergeSort, но он должен быть стабильным.)
Этот класс является членом Java Collections Framework.
- Since:
- 1.2
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
static <T> List<T> |
asList |
Возвращает список фиксированного размера, поддерживаемый указанным массивом. |
static int |
binarySearch |
Ищет указанное значение в указанном массиве байтов, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в диапазоне указанного массива байтов, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в указанном массиве символов, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в диапазоне указанного массива символов, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в указанном массиве чисел с плавающей точкой двойной точности, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в диапазоне указанного массива чисел с плавающей точкой двойной точности, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в указанном массиве чисел с плавающей точкой одинарной точности, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в диапазоне указанного массива чисел с плавающей точкой одинарной точности, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в указанном массиве целых чисел, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в диапазоне указанного массива целых чисел, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в диапазоне указанного массива длинных целых чисел, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в указанном массиве длинных целых чисел, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в диапазоне указанного массива коротких целых чисел, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанное значение в указанном массиве коротких целых чисел, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанный объект в диапазоне указанного массива, используя алгоритм двоичного поиска. |
static int |
binarySearch |
Ищет указанный объект в указанном массиве, используя алгоритм двоичного поиска. |
static <T> int |
binarySearch |
Ищет указанный объект в диапазоне указанного массива, используя алгоритм двоичного поиска. |
static <T> int |
binarySearch |
Ищет указанный объект в указанном массиве, используя алгоритм двоичного поиска. |
static int |
compare |
Сравнивает два массива boolean лексикографически. |
static int |
compare |
Сравнивает два массива boolean лексикографически в указанных диапазонах. |
static int |
compare |
Сравнивает два массива byte лексикографически. |
static int |
compare |
Сравнивает два массива byte лексикографически в указанных диапазонах. |
static int |
compare |
Сравнивает два массива char лексикографически. |
static int |
compare |
Сравнивает два массива char лексикографически в указанных диапазонах. |
static int |
compare |
Сравнивает два массива double лексикографически. |
static int |
compare |
Сравнивает два массива double лексикографически в указанных диапазонах. |
static int |
compare |
Сравнивает два массива float лексикографически. |
static int |
compare |
Сравнивает два массива float лексикографически в указанных диапазонах. |
static int |
compare |
Сравнивает два массива int лексикографически. |
static int |
compare |
Сравнивает два массива int лексикографически в указанных диапазонах. |
static int |
compare |
Сравнивает два массива long лексикографически в указанных диапазонах. |
static int |
compare |
Сравнивает два массива long лексикографически. |
static int |
compare |
Сравнивает два массива short лексикографически в указанных диапазонах. |
static int |
compare |
Сравнивает два массива short лексикографически. |
static <T extends Comparable<? super T>> |
compare |
Сравнивает два массива Object лексикографически в указанных диапазонах. |
static <T> int |
compare |
Сравнивает два массива Object лексикографически в указанных диапазонах. |
static <T extends Comparable<? super T>> |
compare |
Сравнивает два массива Object лексикографически, внутри сравнимых элементов. |
static <T> int |
compare |
Сравнивает два массива Object лексикографически, используя указанный компаратор. |
static int |
compareUnsigned |
Сравнивает два массива byte лексикографически, численно обрабатывая элементы как беззнаковые. |
static int |
compareUnsigned |
Сравнивает два массива byte лексикографически в указанных диапазонах, численно обрабатывая элементы как беззнаковые. |
static int |
compareUnsigned |
Сравнивает два массива int лексикографически, численно обрабатывая элементы как беззнаковые. |
static int |
compareUnsigned |
Сравнивает два массива int лексикографически в указанных диапазонах, численно обрабатывая элементы как беззнаковые. |
static int |
compareUnsigned |
Сравнивает два массива long лексикографически в указанных диапазонах, численно обрабатывая элементы как беззнаковые. |
static int |
compareUnsigned |
Сравнивает два массива long лексикографически, численно обрабатывая элементы как беззнаковые. |
static int |
compareUnsigned |
Сравнивает два массива short лексикографически в указанных диапазонах, численно обрабатывая элементы как беззнаковые. |
static int |
compareUnsigned |
Сравнивает два массива short лексикографически, численно обрабатывая элементы как беззнаковые. |
static boolean[] |
copyOf |
Копирует указанный массив, усекая или дополняя false (при необходимости), чтобы копия имела указанную длину. |
static byte[] |
copyOf |
Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. |
static char[] |
copyOf |
Копирует указанный массив, усекая или дополняя нулевыми символами (при необходимости), чтобы копия имела указанную длину. |
static double[] |
copyOf |
Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. |
static float[] |
copyOf |
Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. |
static int[] |
copyOf |
Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. |
static long[] |
copyOf |
Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. |
static short[] |
copyOf |
Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. |
static <T> T[] |
copyOf |
Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. |
static <T, |
copyOf |
Копирует указанный массив, усекая или дополняя null (при необходимости), чтобы копия имела указанную длину. |
static boolean[] |
copyOfRange |
Копирует указанный диапазон указанного массива в новый массив. |
static byte[] |
copyOfRange |
Копирует указанный диапазон указанного массива в новый массив. |
static char[] |
copyOfRange |
Копирует указанный диапазон указанного массива в новый массив. |
static double[] |
copyOfRange |
Копирует указанный диапазон указанного массива в новый массив. |
static float[] |
copyOfRange |
Копирует указанный диапазон указанного массива в новый массив. |
static int[] |
copyOfRange |
Копирует указанный диапазон указанного массива в новый массив. |
static long[] |
copyOfRange |
Копирует указанный диапазон указанного массива в новый массив. |
static short[] |
copyOfRange |
Копирует указанный диапазон указанного массива в новый массив. |
static <T> T[] |
copyOfRange |
Копирует указанный диапазон указанного массива в новый массив. |
static <T, |
copyOfRange |
Копирует указанный диапазон указанного массива в новый массив. |
static boolean |
deepEquals |
Возвращает true, если два указанных массива полностью равны друг другу. |
static int |
deepHashCode |
Возвращает хэш-код на основе "глубокого содержимого" указанного массива. |
static String |
deepToString |
Возвращает строковое представление "глубокого содержимого" указанного массива. |
static boolean |
equals |
Возвращает true, если два указанных массива булевых значений равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива булевых значений, в указанных диапазонах, равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива байтов равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива байтов, в указанных диапазонах, равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива символов равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива символов, в указанных диапазонах, равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива чисел с плавающей точкой двойной точности равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива чисел с плавающей точкой двойной точности, в указанных диапазонах, равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива чисел с плавающей точкой одинарной точности равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива чисел с плавающей точкой одинарной точности, в указанных диапазонах, равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива целых чисел равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива целых чисел, в указанных диапазонах, равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива длинных целых чисел, в указанных диапазонах, равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива длинных целых чисел равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива коротких целых чисел, в указанных диапазонах, равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива коротких целых чисел равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива объектов, в указанных диапазонах, равны друг другу. |
static boolean |
equals |
Возвращает true, если два указанных массива объектов равны друг другу. |
static <T> boolean |
equals |
Возвращает true, если два указанных массива объектов, в указанных диапазонах, равны друг другу. |
static <T> boolean |
equals |
Возвращает true, если два указанных массива объектов равны друг другу. |
static void |
fill |
Присваивает указанное булево значение каждому элементу указанного массива булевых значений. |
static void |
fill |
Присваивает указанное булево значение каждому элементу указанного диапазона указанного массива булевых значений. |
static void |
fill |
Присваивает указанное значение байта каждому элементу указанного массива байтов. |
static void |
fill |
Присваивает указанное значение байта каждому элементу указанного диапазона указанного массива байтов. |
static void |
fill |
Присваивает указанное значение символа каждому элементу указанного массива символов. |
static void |
fill |
Присваивает указанное значение символа каждому элементу указанного диапазона указанного массива символов. |
static void |
fill |
Присваивает указанное значение с плавающей точкой двойной точности каждому элементу указанного массива чисел с плавающей точкой двойной точности. |
static void |
fill |
Присваивает указанное значение с плавающей точкой двойной точности каждому элементу указанного диапазона указанного массива чисел с плавающей точкой двойной точности. |
static void |
fill |
Присваивает указанное значение с плавающей точкой одинарной точности каждому элементу указанного массива чисел с плавающей точкой одинарной точности. |
static void |
fill |
Присваивает указанное значение с плавающей точкой одинарной точности каждому элементу указанного диапазона указанного массива чисел с плавающей точкой одинарной точности. |
static void |
fill |
Присваивает указанное целочисленное значение каждому элементу указанного массива целых чисел. |
static void |
fill |
Присваивает указанное целочисленное значение каждому элементу указанного диапазона указанного массива целых чисел. |
static void |
fill |
Присваивает указанное значение длинного целого числа каждому элементу указанного диапазона указанного массива длинных целых чисел. |
static void |
fill |
Присваивает указанное значение длинного целого числа каждому элементу указанного массива длинных целых чисел. |
static void |
fill |
Присваивает указанное значение короткого целого числа каждому элементу указанного диапазона указанного массива коротких целых чисел. |
static void |
fill |
Присваивает указанное значение короткого целого числа каждому элементу указанного массива коротких целых чисел. |
static void |
fill |
Присваивает указанную ссылку на объект каждому элементу указанного диапазона указанного массива объектов. |
static void |
fill |
Присваивает указанный объектный референс каждому элементу указанного массива объектов. |
static int |
hashCode |
Возвращает хэш-код на основе содержимого указанного массива. |
static int |
hashCode |
Возвращает хэш-код на основе содержимого указанного массива. |
static int |
hashCode |
Возвращает хэш-код на основе содержимого указанного массива. |
static int |
hashCode |
Возвращает хэш-код на основе содержимого указанного массива. |
static int |
hashCode |
Возвращает хэш-код на основе содержимого указанного массива. |
static int |
hashCode |
Возвращает хэш-код на основе содержимого указанного массива. |
static int |
hashCode |
Возвращает хэш-код на основе содержимого указанного массива. |
static int |
hashCode |
Возвращает хэш-код на основе содержимого указанного массива. |
static int |
hashCode |
Возвращает хэш-код на основе содержимого указанного массива. |
static int |
mismatch |
Находит и возвращает индекс первого несовпадения между двумя boolean массивами, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает относительный индекс первого несовпадения между двумя boolean массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает индекс первого несовпадения между двумя byte массивами, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает относительный индекс первого несовпадения между двумя byte массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает индекс первого несовпадения между двумя char массивами, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает относительный индекс первого несовпадения между двумя char массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает индекс первого несовпадения между двумя double массивами, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает относительный индекс первого несовпадения между двумя double массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает индекс первого несовпадения между двумя float массивами, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает относительный индекс первого несовпадения между двумя float массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает индекс первого несовпадения между двумя int массивами, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает относительный индекс первого несовпадения между двумя int массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает относительный индекс первого несовпадения между двумя long массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает индекс первого несовпадения между двумя long массивами, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает относительный индекс первого несовпадения между двумя short массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает индекс первого несовпадения между двумя short массивами, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает относительный индекс первого несовпадения между двумя Object массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадений не найдено. |
static int |
mismatch |
Находит и возвращает индекс первого несовпадения между двумя Object массивами, в противном случае возвращает -1, если несовпадений не найдено. |
static <T> int |
mismatch |
Находит и возвращает относительный индекс первого несовпадения между двумя Object массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадений не найдено. |
static <T> int |
mismatch |
Находит и возвращает индекс первого несовпадения между двумя Object массивами, в противном случае возвращает -1, если несовпадений не найдено. |
static void |
parallelPrefix |
Выполняет parallelPrefix(double[], DoubleBinaryOperator) для заданного поддиапазона массива. |
static void |
parallelPrefix |
Параллельно накапливает каждый элемент данного массива на месте, используя предоставленную функцию. |
static void |
parallelPrefix |
Выполняет parallelPrefix(int[], IntBinaryOperator) для заданного поддиапазона массива. |
static void |
parallelPrefix |
Параллельно накапливает каждый элемент данного массива на месте, используя предоставленную функцию. |
static void |
parallelPrefix |
Выполняет parallelPrefix(long[], LongBinaryOperator) для заданного поддиапазона массива. |
static void |
parallelPrefix |
Параллельно накапливает каждый элемент данного массива на месте, используя предоставленную функцию. |
static <T> void |
parallelPrefix |
Выполняет parallelPrefix(Object[], BinaryOperator) для заданного поддиапазона массива. |
static <T> void |
parallelPrefix |
Параллельно накапливает каждый элемент данного массива на месте, используя предоставленную функцию. |
static void |
parallelSetAll |
Устанавливает все элементы указанного массива параллельно, используя предоставленную функцию генератора для вычисления каждого элемента. |
static void |
parallelSetAll |
Устанавливает все элементы указанного массива параллельно, используя предоставленную функцию генератора для вычисления каждого элемента. |
static void |
parallelSetAll |
Устанавливает все элементы указанного массива параллельно, используя предоставленную функцию генератора для вычисления каждого элемента. |
static <T> void |
parallelSetAll |
Устанавливает все элементы указанного массива параллельно, используя предоставленную функцию генератора для вычисления каждого элемента. |
static void |
parallelSort |
Сортирует указанный массив в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный массив в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный массив в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный массив в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный массив в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный массив в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный массив в порядке возрастания. |
static void |
parallelSort |
Сортирует указанный диапазон массива в порядке возрастания. |
static <T extends Comparable<? super T>> |
parallelSort |
Сортирует указанный массив объектов в порядке возрастания, согласно естественному порядку его элементов. |
static <T extends Comparable<? super T>> |
parallelSort |
Сортирует указанный диапазон указанного массива объектов в порядке возрастания, согласно естественному порядку его элементов. |
static <T> void |
parallelSort |
Сортирует указанный диапазон указанного массива объектов в соответствии с порядком, заданным указанным компаратором. |
static <T> void |
parallelSort |
Сортирует указанный массив объектов в соответствии с порядком, заданным указанным компаратором. |
static void |
setAll |
Задает все элементы указанного массива, используя предоставленную функцию генератора для вычисления каждого элемента. |
static void |
setAll |
Задает все элементы указанного массива, используя предоставленную функцию генератора для вычисления каждого элемента. |
static void |
setAll |
Задает все элементы указанного массива, используя предоставленную функцию генератора для вычисления каждого элемента. |
static <T> void |
setAll |
Задает все элементы указанного массива, используя предоставленную функцию генератора для вычисления каждого элемента. |
static void |
sort |
Сортирует указанный массив в порядке возрастания. |
static void |
sort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
sort |
Сортирует указанный массив в порядке возрастания. |
static void |
sort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
sort |
Сортирует указанный массив в порядке возрастания. |
static void |
sort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
sort |
Сортирует указанный массив в порядке возрастания. |
static void |
sort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
sort |
Сортирует указанный массив в порядке возрастания. |
static void |
sort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
sort |
Сортирует указанный массив в порядке возрастания. |
static void |
sort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
sort |
Сортирует указанный массив в порядке возрастания. |
static void |
sort |
Сортирует указанный диапазон массива в порядке возрастания. |
static void |
sort |
Сортирует указанный массив объектов в порядке возрастания, согласно естественному порядку его элементов. |
static void |
sort |
Сортирует указанный диапазон указанного массива объектов в порядке возрастания, согласно естественному порядку его элементов. |
static <T> void |
sort |
Сортирует указанный диапазон указанного массива объектов в соответствии с порядком, заданным указанным компаратором. |
static <T> void |
sort |
Сортирует указанный массив объектов в соответствии с порядком, заданным указанным компаратором. |
static Spliterator.OfDouble |
spliterator |
Возвращает Spliterator.OfDouble, охватывающий весь указанный массив. |
static Spliterator.OfDouble |
spliterator |
Возвращает Spliterator.OfDouble, охватывающий указанный диапазон указанного массива. |
static Spliterator.OfInt |
spliterator |
Возвращает Spliterator.OfInt, охватывающий весь указанный массив. |
static Spliterator.OfInt |
spliterator |
Возвращает Spliterator.OfInt, охватывающий указанный диапазон указанного массива. |
static Spliterator.OfLong |
spliterator |
Возвращает Spliterator.OfLong, охватывающий весь указанный массив. |
static Spliterator.OfLong |
spliterator |
Возвращает Spliterator.OfLong, охватывающий указанный диапазон указанного массива. |
static <T> Spliterator<T> |
spliterator |
Возвращает Spliterator, охватывающий весь указанный массив. |
static <T> Spliterator<T> |
spliterator |
Возвращает Spliterator, охватывающий указанный диапазон указанного массива. |
static DoubleStream |
stream |
Возвращает последовательный DoubleStream с указанным массивом в качестве источника. |
static DoubleStream |
stream |
Возвращает последовательный DoubleStream с указанным диапазоном указанного массива в качестве источника. |
static IntStream |
stream |
Возвращает последовательный IntStream с указанным массивом в качестве источника. |
static IntStream |
stream |
Возвращает последовательный IntStream с указанным диапазоном указанного массива в качестве источника. |
static LongStream |
stream |
Возвращает последовательный LongStream с указанным массивом в качестве источника. |
static LongStream |
stream |
Возвращает последовательный LongStream с указанным диапазоном указанного массива в качестве источника. |
static <T> Stream<T> |
stream |
Возвращает последовательный Stream с указанным массивом в качестве источника. |
static <T> Stream<T> |
stream |
Возвращает последовательный Stream с указанным диапазоном указанного массива в качестве источника. |
static String |
toString |
Возвращает строковое представление содержимого указанного массива. |
static String |
toString |
Возвращает строковое представление содержимого указанного массива. |
static String |
toString |
Возвращает строковое представление содержимого указанного массива. |
static String |
toString |
Возвращает строковое представление содержимого указанного массива. |
static String |
toString |
Возвращает строковое представление содержимого указанного массива. |
static String |
toString |
Возвращает строковое представление содержимого указанного массива. |
static String |
toString |
Возвращает строковое представление содержимого указанного массива. |
static String |
toString |
Возвращает строковое представление содержимого указанного массива. |
static String |
toString |
Возвращает строковое представление содержимого указанного массива. |
Подробное описание методов
sort
public static void sort(int[] a)
- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать
sort
public static void sort(int[] a, int fromIndex, int toIndex)
fromIndex (включительно) до индекса toIndex (исключительно). Если fromIndex == toIndex, диапазон для сортировки пуст.- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать -
fromIndex- индекс первого элемента (включительно), который нужно отсортировать -
toIndex- индекс последнего элемента (исключительно), который нужно отсортировать - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
sort
public static void sort(long[] a)
- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать
sort
public static void sort(long[] a, int fromIndex, int toIndex)
fromIndex (включительно) до индекса toIndex (исключительно). Если fromIndex == toIndex, диапазон для сортировки пуст.- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать -
fromIndex- индекс первого элемента (включительно), который нужно отсортировать -
toIndex- индекс последнего элемента (исключительно), который нужно отсортировать - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
sort
public static void sort(short[] a)
- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать
sort
public static void sort(short[] a, int fromIndex, int toIndex)
fromIndex (включительно) до индекса toIndex (исключительно). Если fromIndex == toIndex, диапазон для сортировки пуст.- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать -
fromIndex- индекс первого элемента (включительно), который нужно отсортировать -
toIndex- индекс последнего элемента (исключительно), который нужно отсортировать - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
sort
public static void sort(char[] a)
- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать
sort
public static void sort(char[] a, int fromIndex, int toIndex)
fromIndex (включительно) до индекса toIndex (исключительно). Если fromIndex == toIndex, диапазон для сортировки пуст.- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать -
fromIndex- индекс первого элемента (включительно), который нужно отсортировать -
toIndex- индекс последнего элемента (исключительно), который нужно отсортировать - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
sort
public static void sort(byte[] a)
- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать
sort
public static void sort(byte[] a, int fromIndex, int toIndex)
fromIndex (включительно) до индекса toIndex (исключительно). Если fromIndex == toIndex, диапазон для сортировки пуст.- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать -
fromIndex- индекс первого элемента (включительно), который нужно отсортировать -
toIndex- индекс последнего элемента (исключительно), который нужно отсортировать - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
sort
public static void sort(float[] a)
Отношение < не обеспечивает полного порядка для всех значений float: -0.0f == 0.0f является true и значение Float.NaN не сравнивается ни меньше, ни больше, ни равно любому значению, даже самому себе. Данный метод использует полный порядок, заданный методом Float.compareTo(java.lang.Float): -0.0f считается меньше значения 0.0f, а Float.NaN считается больше любого другого значения, и все Float.NaN значения считаются равными.
- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать
sort
public static void sort(float[] a, int fromIndex, int toIndex)
fromIndex (включительно) до индекса toIndex (исключительно). Если fromIndex == toIndex, диапазон для сортировки пуст. Отношение < не обеспечивает полного порядка для всех значений float: -0.0f == 0.0f является true и значение Float.NaN не сравнивается ни меньше, ни больше, ни равно любому значению, даже самому себе. Данный метод использует полный порядок, заданный методом Float.compareTo(java.lang.Float): -0.0f считается меньше значения 0.0f, а Float.NaN считается больше любого другого значения, и все Float.NaN значения считаются равными.
- Описание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним pivot).
- Параметры:
-
a- массив, который нужно отсортировать -
fromIndex- индекс первого элемента (включительно), который нужно отсортировать -
toIndex- индекс последнего элемента (исключительно), который нужно отсортировать - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
sort
public static void sort(double[] a)
Отношение < не обеспечивает полного порядка для всех значений типа double: -0.0d == 0.0d является true и значение типа Double.NaN не сравнивается ни меньше, ни больше, ни равно любому значению, даже самому себе. Данный метод использует полный порядок, заданный методом Double.compareTo(java.lang.Double): значение -0.0d считается меньше значения 0.0d, и Double.NaN считается больше любого другого значения, а все Double.NaN значения считаются равными.
- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив
sort
public static void sort(double[] a, int fromIndex, int toIndex)
fromIndex включительно до индекса toIndex, не включительно. Если fromIndex == toIndex, то сортируемый диапазон пуст. Отношение < не обеспечивает полного порядка для всех значений типа double: -0.0d == 0.0d является true и значение типа Double.NaN не сравнивается ни меньше, ни больше, ни равно любому значению, даже самому себе. Данный метод использует полный порядок, заданный методом Double.compareTo(java.lang.Double): значение -0.0d считается меньше значения 0.0d, и Double.NaN считается больше любого другого значения, а все Double.NaN значения считаются равными.
- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
parallelSort
public static void parallelSort(byte[] a)
- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив - Since:
- 1.8
parallelSort
public static void parallelSort(byte[] a, int fromIndex, int toIndex)
fromIndex включительно до индекса toIndex, исключая его. Если fromIndex == toIndex, то сортируемый диапазон пуст.- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length - Since:
- 1.8
parallelSort
public static void parallelSort(char[] a)
- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив - Since:
- 1.8
parallelSort
public static void parallelSort(char[] a, int fromIndex, int toIndex)
fromIndex включительно до индекса toIndex, исключая его. Если fromIndex == toIndex, то сортируемый диапазон пуст.- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length - Since:
- 1.8
parallelSort
public static void parallelSort(short[] a)
- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив - Since:
- 1.8
parallelSort
public static void parallelSort(short[] a, int fromIndex, int toIndex)
fromIndex включительно до индекса toIndex, исключая его. Если fromIndex == toIndex, то сортируемый диапазон пуст.- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length - Since:
- 1.8
parallelSort
public static void parallelSort(int[] a)
- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив - Since:
- 1.8
parallelSort
public static void parallelSort(int[] a, int fromIndex, int toIndex)
fromIndex включительно до индекса toIndex, исключая его. Если fromIndex == toIndex, то сортируемый диапазон пуст.- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length - Since:
- 1.8
parallelSort
public static void parallelSort(long[] a)
- Implementation Note:
- Алгоритм сортировки — Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно быстрее, чем традиционные реализации Quicksort (с одним pivотом).
- Parameters:
-
a- сортируемый массив - Since:
- 1.8
parallelSort
public static void parallelSort(long[] a, int fromIndex, int toIndex)
fromIndex (включительно) до индекса toIndex (исключительно). Если fromIndex == toIndex, диапазон для сортировки пустой.- Примечание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошем Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним опорным элементом).
- Параметры:
-
a- сортируемый массив -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length - С:
- 1.8
parallelSort
public static void parallelSort(float[] a)
Отношение < не предоставляет полной упорядоченности для всех значений типа float: -0.0f == 0.0f является true, а значение Float.NaN не сравнивается ни меньше, ни больше, ни равно ни одному значению, даже самому себе. Этот метод использует полную упорядоченность, заданную методом Float.compareTo(java.lang.Float): значение -0.0f считается меньше значения 0.0f, а Float.NaN больше любого другого значения, и все значения Float.NaN считаются равными.
- Примечание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошем Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним опорным элементом).
- Параметры:
-
a- сортируемый массив - С:
- 1.8
parallelSort
public static void parallelSort(float[] a, int fromIndex, int toIndex)
fromIndex (включительно) до индекса toIndex (исключительно). Если fromIndex == toIndex, диапазон для сортировки пустой. Отношение < не предоставляет полной упорядоченности для всех значений типа float: -0.0f == 0.0f является true, а значение Float.NaN не сравнивается ни меньше, ни больше, ни равно ни одному значению, даже самому себе. Этот метод использует полную упорядоченность, заданную методом Float.compareTo(java.lang.Float): значение -0.0f считается меньше значения 0.0f, а Float.NaN больше любого другого значения, и все значения Float.NaN считаются равными.
- Примечание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошем Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним опорным элементом).
- Параметры:
-
a- сортируемый массив -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length - С:
- 1.8
parallelSort
public static void parallelSort(double[] a)
Отношение < не предоставляет полной упорядоченности для всех значений типа double: -0.0d == 0.0d является true, а значение Double.NaN не сравнивается ни меньше, ни больше, ни равно ни одному значению, даже самому себе. Этот метод использует полную упорядоченность, заданную методом Double.compareTo(java.lang.Double): значение -0.0d считается меньше значения 0.0d, а Double.NaN больше любого другого значения, и все значения Double.NaN считаются равными.
- Примечание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошем Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним опорным элементом).
- Параметры:
-
a- сортируемый массив - С:
- 1.8
parallelSort
public static void parallelSort(double[] a, int fromIndex, int toIndex)
fromIndex (включительно) до индекса toIndex (исключительно). Если fromIndex == toIndex, диапазон для сортировки пустой. Отношение < не предоставляет полной упорядоченности для всех значений типа double: -0.0d == 0.0d является true, а значение Double.NaN не сравнивается ни меньше, ни больше, ни равно ни одному значению, даже самому себе. Этот метод использует полную упорядоченность, заданную методом Double.compareTo(java.lang.Double): значение -0.0d считается меньше значения 0.0d, а Double.NaN больше любого другого значения, и все значения Double.NaN считаются равными.
- Примечание реализации:
- Алгоритм сортировки — это Dual-Pivot Quicksort, разработанный Владимиром Ярошевским, Джоном Бентли и Джошем Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и, как правило, быстрее, чем традиционные реализации Quicksort (с одним опорным элементом).
- Параметры:
-
a- сортируемый массив -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length - С:
- 1.8
parallelSort
public static <T extends Comparable<? super T>> void parallelSort(T[] a)
Comparable. Кроме того, все элементы массива должны быть взаимно сравнимы (то есть, e1.compareTo(e2) не должен выбрасывать исключение ClassCastException для любых элементов e1 и e2 в массиве). Эта сортировка гарантированно стабильна: равные элементы не будут переупорядочены в результате сортировки.
- Примечание реализации:
- Алгоритм сортировки — это параллельная сортировка-слияние, которая разбивает массив на подмассивы, которые сами по себе отсортированы, а затем сливаются. Когда длина подмассива достигает минимального размера, подмассив сортируется с использованием соответствующего метода
Arrays.sort. Если длина указанного массива меньше минимального размера, он сортируется с помощью соответствующего методаArrays.sort. Алгоритм требует рабочего пространства, не превышающего размер исходного массива. Для выполнения любых параллельных задач используетсяForkJoin common pool. - Параметры типа:
-
T- класс объектов, подлежащих сортировке - Параметры:
-
a- сортируемый массив - Исключения:
-
ClassCastException- если массив содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа) -
IllegalArgumentException- (необязательно) если естественный порядок элементов массива нарушает контракт интерфейсаComparable - С:
- 1.8
parallelSort
public static <T extends Comparable<? super T>> void parallelSort(T[] a, int fromIndex, int toIndex)
fromIndex включительно до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон, подлежащий сортировке, пуст.) Все элементы в этом диапазоне должны реализовывать интерфейс Comparable. Кроме того, все элементы в этом диапазоне должны быть взаимно сравнимы (то есть e1.compareTo(e2) не должно выбрасывать ClassCastException для любых элементов e1 и e2 в массиве). Эта сортировка гарантированно является стабильной: равные элементы не будут переупорядочены в результате сортировки.
- Implementation Note:
- Алгоритм сортировки — это параллельная сортировка-слияние, разбивающая массив на подмассивы, которые сами сортируются, а затем сливаются. Когда длина подмассива достигает минимальной зернистости, подмассив сортируется с помощью соответствующего метода
Arrays.sort. Если длина указанного массива меньше минимальной зернистости, он сортируется с помощью соответствующего методаArrays.sort. Алгоритм требует рабочего пространства не больше размера указанного диапазона исходного массива. Для выполнения любых параллельных задач используетсяForkJoin common pool. - Type Parameters:
-
T- класс объектов, подлежащих сортировке - Parameters:
-
a- массив, подлежащий сортировке -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndexили (необязательно) если естественный порядок элементов массива нарушает контрактComparable -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length -
ClassCastException- если массив содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа). - Since:
- 1.8
parallelSort
public static <T> void parallelSort(T[] a, Comparator<? super T> cmp)
c.compare(e1, e2) не должно выбрасывать ClassCastException для любых элементов e1 и e2 в массиве). Эта сортировка гарантированно является стабильной: равные элементы не будут переупорядочены в результате сортировки.
- Implementation Note:
- Алгоритм сортировки — это параллельная сортировка-слияние, разбивающая массив на подмассивы, которые сами сортируются, а затем сливаются. Когда длина подмассива достигает минимальной зернистости, подмассив сортируется с помощью соответствующего метода
Arrays.sort. Если длина указанного массива меньше минимальной зернистости, он сортируется с помощью соответствующего методаArrays.sort. Алгоритм требует рабочего пространства не больше размера исходного массива. Для выполнения любых параллельных задач используетсяForkJoin common pool. - Type Parameters:
-
T- класс объектов, подлежащих сортировке - Parameters:
-
a- массив, подлежащий сортировке -
cmp- компаратор для определения порядка массива. Значениеnullуказывает на то, что следует использовать естественный порядок элементов. - Throws:
-
ClassCastException- если массив содержит элементы, которые не являются взаимно сравнимыми с использованием указанного компаратора -
IllegalArgumentException- (необязательно) если компаратор нарушает контрактComparator - Since:
- 1.8
parallelSort
public static <T> void parallelSort(T[] a, int fromIndex, int toIndex, Comparator<? super T> cmp)
fromIndex включительно до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон, подлежащий сортировке, пуст.) Все элементы в диапазоне должны быть взаимно сравнимы с помощью указанного компаратора (то есть c.compare(e1, e2) не должно выбрасывать ClassCastException для любых элементов e1 и e2 в диапазоне). Эта сортировка гарантированно является стабильной: равные элементы не будут переупорядочены в результате сортировки.
- Implementation Note:
- Алгоритм сортировки — это параллельная сортировка-слияние, разбивающая массив на подмассивы, которые сами сортируются, а затем сливаются. Когда длина подмассива достигает минимальной зернистости, подмассив сортируется с помощью соответствующего метода
Arrays.sort. Если длина указанного массива меньше минимальной зернистости, он сортируется с помощью соответствующего методаArrays.sort. Алгоритм требует рабочего пространства не больше размера указанного диапазона исходного массива. Для выполнения любых параллельных задач используетсяForkJoin common pool. - Type Parameters:
-
T- класс объектов, подлежащих сортировке - Parameters:
-
a- массив, подлежащий сортировке -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке -
cmp- компаратор для определения порядка массива. Значениеnullуказывает на то, что следует использовать естественный порядок элементов. - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndexили (необязательно) если естественный порядок элементов массива нарушает контрактComparable -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length -
ClassCastException- если массив содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа). - Since:
- 1.8
sort
public static void sort(Object[] a)
Comparable. Кроме того, все элементы в массиве должны быть взаимно сравнимы (то есть e1.compareTo(e2) не должно выбрасывать ClassCastException для любых элементов e1 и e2 в массиве). Эта сортировка гарантированно является стабильной: равные элементы не будут переупорядочены в результате сортировки.
Примечание по реализации: Эта реализация — стабильная, адаптивная, итеративная сортировка слиянием, которая требует значительно меньше, чем n lg(n) сравнений, когда входной массив частично отсортирован, предлагая производительность традиционной сортировки слиянием, когда входной массив случайно упорядочен. Если входной массив почти отсортирован, реализация требует примерно n сравнений. Требования к временной памяти варьируются от небольшой константы для почти отсортированных массивов до n/2 ссылок на объекты для случайно упорядоченных массивов.
Реализация одинаково эффективно использует порядок возрастания и убывания в входном массиве и может использовать порядок возрастания и убывания в разных частях одного входного массива. Она хорошо подходит для слияния двух или более отсортированных массивов: достаточно объединить массивы и отсортировать результирующий массив.
Реализация была адаптирована из сортировки списков Tim Peters для Python ( TimSort). Она использует методы из работы Peter McIlroy «Optimistic Sorting and Information Theoretic Complexity», Proceedings of the Fourth Annual ACM-SIAM Symposium on Discrete Algorithms, pp 467-474, январь 1993.
- Parameters:
-
a- массив, подлежащий сортировке - Throws:
-
ClassCastException- если массив содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа) -
IllegalArgumentException- (необязательно) если естественный порядок элементов массива нарушает контрактComparable
sort
public static void sort(Object[] a, int fromIndex, int toIndex)
fromIndex включительно до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон, подлежащий сортировке, пуст.) Все элементы в этом диапазоне должны реализовывать интерфейс Comparable. Кроме того, все элементы в этом диапазоне должны быть взаимосравнимыми (то есть, e1.compareTo(e2) не должно выбрасывать исключение ClassCastException для любых элементов e1 и e2 в массиве). Эта сортировка гарантированно стабильна: равные элементы не будут переупорядочены в результате сортировки.
Примечание по реализации: Эта реализация представляет собой стабильную, адаптивную, итеративную сортировку слиянием, которая требует значительно меньше, чем n lg(n) сравнений, когда входной массив частично отсортирован, предлагая производительность традиционной сортировки слиянием при случайном порядке элементов входного массива. Если входной массив почти отсортирован, реализация требует приблизительно n сравнений. Требования к временной памяти варьируются от небольшой константы для почти отсортированных массивов до n/2 ссылок на объекты для массивов со случайным порядком.
Реализация одинаково эффективно использует возрастающий и убывающий порядок в своём входном массиве и может использовать возрастающий и убывающий порядок в разных частях одного и того же входного массива. Она хорошо подходит для слияния двух или более отсортированных массивов: просто объедините массивы и отсортируйте результирующий массив.
Реализация была адаптирована из сортировки списков Tim Peters для Python ( TimSort). Она использует методики из работы Питера МакИлроя "Оптимистичная сортировка и сложность, основанная на теории информации", в материалах четвёртой ежегодной конференции ACM-SIAM по дискретным алгоритмам, стр. 467-474, январь 1993 года.
- Parameters:
-
a- массив, подлежащий сортировке -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndexили (необязательно) если естественный порядок элементов массива нарушает контрактComparable -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length -
ClassCastException- если массив содержит элементы, которые не являются взаимосравнимыми (например, строки и целые числа).
sort
public static <T> void sort(T[] a, Comparator<? super T> c)
c.compare(e1, e2) не должно выбрасывать исключение ClassCastException для любых элементов e1 и e2 в массиве). Эта сортировка гарантированно стабильна: равные элементы не будут переупорядочены в результате сортировки.
Примечание по реализации: Эта реализация представляет собой стабильную, адаптивную, итеративную сортировку слиянием, которая требует значительно меньше, чем n lg(n) сравнений, когда входной массив частично отсортирован, предлагая производительность традиционной сортировки слиянием при случайном порядке элементов входного массива. Если входной массив почти отсортирован, реализация требует приблизительно n сравнений. Требования к временной памяти варьируются от небольшой константы для почти отсортированных массивов до n/2 ссылок на объекты для массивов со случайным порядком.
Реализация одинаково эффективно использует возрастающий и убывающий порядок в своём входном массиве и может использовать возрастающий и убывающий порядок в разных частях одного и того же входного массива. Она хорошо подходит для слияния двух или более отсортированных массивов: просто объедините массивы и отсортируйте результирующий массив.
Реализация была адаптирована из сортировки списков Tim Peters для Python ( TimSort). Она использует методики из работы Питера МакИлроя "Оптимистичная сортировка и сложность, основанная на теории информации", в материалах четвёртой ежегодной конференции ACM-SIAM по дискретным алгоритмам, стр. 467-474, январь 1993 года.
- Type Parameters:
-
T- класс объектов, подлежащих сортировке - Parameters:
-
a- массив, подлежащий сортировке -
c- компаратор для определения порядка массива. Значениеnullуказывает на то, что должен использоваться естественный порядок элементов. - Throws:
-
ClassCastException- если массив содержит элементы, которые не являются взаимосравнимыми с помощью указанного компаратора -
IllegalArgumentException- (необязательно) если компаратор нарушает контрактComparator
sort
public static <T> void sort(T[] a, int fromIndex, int toIndex, Comparator<? super T> c)
fromIndex включительно до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон, подлежащий сортировке, пуст.) Все элементы в диапазоне должны быть взаимосравнимыми с помощью указанного компаратора (то есть, c.compare(e1, e2) не должно выбрасывать исключение ClassCastException для любых элементов e1 и e2 в диапазоне). Эта сортировка гарантированно стабильна: равные элементы не будут переупорядочены в результате сортировки.
Примечание по реализации: Эта реализация представляет собой стабильную, адаптивную, итеративную сортировку слиянием, которая требует значительно меньше, чем n lg(n) сравнений, когда входной массив частично отсортирован, предлагая производительность традиционной сортировки слиянием при случайном порядке элементов входного массива. Если входной массив почти отсортирован, реализация требует приблизительно n сравнений. Требования к временной памяти варьируются от небольшой константы для почти отсортированных массивов до n/2 ссылок на объекты для массивов со случайным порядком.
Реализация одинаково эффективно использует возрастающий и убывающий порядок в своём входном массиве и может использовать возрастающий и убывающий порядок в разных частях одного и того же входного массива. Она хорошо подходит для слияния двух или более отсортированных массивов: просто объедините массивы и отсортируйте результирующий массив.
Реализация была адаптирована из сортировки списков Tim Peters для Python ( TimSort). Она использует методики из работы Питера МакИлроя "Оптимистичная сортировка и сложность, основанная на теории информации", в материалах четвёртой ежегодной конференции ACM-SIAM по дискретным алгоритмам, стр. 467-474, январь 1993 года.
- Type Parameters:
-
T- класс объектов, подлежащих сортировке - Parameters:
-
a- массив, подлежащий сортировке -
fromIndex- индекс первого элемента (включительно), подлежащего сортировке -
toIndex- индекс последнего элемента (исключительно), подлежащего сортировке -
c- компаратор для определения порядка массива. Значениеnullуказывает на то, что должен использоваться естественный порядок элементов. - Throws:
-
ClassCastException- если массив содержит элементы, которые не являются взаимосравнимыми с помощью указанного компаратора. -
IllegalArgumentException- еслиfromIndex > toIndexили (необязательно) если компаратор нарушает контрактComparator -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
parallelPrefix
public static <T> void parallelPrefix(T[] array, BinaryOperator<T> op)
[2, 1, 0, 3], а операция представляет собой сложение, то после выполнения метода массив будет содержать [2, 3, 3, 6]. Параллельное вычисление префикса обычно более эффективно, чем последовательные циклы для больших массивов.- Type Parameters:
-
T- класс объектов в массиве - Parameters:
-
array- массив, который изменяется на месте данным методом -
op- функция, не имеющая побочных эффектов и ассоциативная, для выполнения кумуляции - Throws:
-
NullPointerException- если указанный массив или функция равны null - Since:
- 1.8
parallelPrefix
public static <T> void parallelPrefix(T[] array, int fromIndex, int toIndex, BinaryOperator<T> op)
parallelPrefix(Object[], BinaryOperator) для заданного поддиапазона массива.- Type Parameters:
-
T- класс объектов в массиве - Parameters:
-
array- массив -
fromIndex- индекс первого элемента, включая -
toIndex- индекс последнего элемента, не включая -
op- функция, не имеющая побочных эффектов и ассоциативная, для выполнения кумуляции - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > array.length -
NullPointerException- если указанный массив или функция равны null - Since:
- 1.8
параллельныйПрефикс
public static void parallelPrefix(long[] array, LongBinaryOperator op)
[2, 1, 0, 3], а операция выполняет сложение, то по возвращении массив будет содержать [2, 3, 3, 6]. Вычисление параллельного префикса обычно более эффективно, чем циклы последовательности для больших массивов.- Параметры:
-
array- массив, который изменяется на месте этим методом -
op- функция без побочных эффектов и ассоциативная для выполнения накопления - Исключения:
-
NullPointerException- если указанный массив или функция равны null - С тех пор:
- 1.8
параллельныйПрефикс
public static void parallelPrefix(long[] array, int fromIndex, int toIndex, LongBinaryOperator op)
parallelPrefix(long[], LongBinaryOperator) для заданного поддиапазона массива.- Параметры:
-
array- массив -
fromIndex- индекс первого элемента, включительно -
toIndex- индекс последнего элемента, исключая его -
op- функция без побочных эффектов и ассоциативная для выполнения накопления - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > array.length -
NullPointerException- если указанный массив или функция равны null - С тех пор:
- 1.8
параллельныйПрефикс
public static void parallelPrefix(double[] array, DoubleBinaryOperator op)
[2.0, 1.0, 0.0, 3.0], а операция выполняет сложение, то по возвращении массив будет содержать [2.0, 3.0, 3.0, 6.0]. Вычисление параллельного префикса обычно более эффективно, чем циклы последовательности для больших массивов. Поскольку операции с плавающей точкой могут не быть строго ассоциативными, возвращаемый результат может не совпадать со значением, которое было бы получено, если бы операция выполнялась последовательно.
- Параметры:
-
array- массив, который изменяется на месте этим методом -
op- функция без побочных эффектов для выполнения накопления - Исключения:
-
NullPointerException- если указанный массив или функция равны null - С тех пор:
- 1.8
параллельныйПрефикс
public static void parallelPrefix(double[] array, int fromIndex, int toIndex, DoubleBinaryOperator op)
parallelPrefix(double[], DoubleBinaryOperator) для заданного поддиапазона массива.- Параметры:
-
array- массив -
fromIndex- индекс первого элемента, включительно -
toIndex- индекс последнего элемента, исключая его -
op- функция без побочных эффектов и ассоциативная для выполнения накопления - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > array.length -
NullPointerException- если указанный массив или функция равны null - С тех пор:
- 1.8
параллельныйПрефикс
public static void parallelPrefix(int[] array, IntBinaryOperator op)
[2, 1, 0, 3], а операция выполняет сложение, то по возвращении массив будет содержать [2, 3, 3, 6]. Вычисление параллельного префикса обычно более эффективно, чем циклы последовательности для больших массивов.- Параметры:
-
array- массив, который изменяется на месте этим методом -
op- функция без побочных эффектов и ассоциативная для выполнения накопления - Исключения:
-
NullPointerException- если указанный массив или функция равны null - С тех пор:
- 1.8
параллельныйПрефикс
public static void parallelPrefix(int[] array, int fromIndex, int toIndex, IntBinaryOperator op)
parallelPrefix(int[], IntBinaryOperator) для заданного поддиапазона массива.- Параметры:
-
array- массив -
fromIndex- индекс первого элемента, включительно -
toIndex- индекс последнего элемента, исключая его -
op- функция без побочных эффектов и ассоциативная для выполнения накопления - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > array.length -
NullPointerException- если указанный массив или функция равны null - С тех пор:
- 1.8
поискДвоичный
public static int binarySearch(long[] a, long key)
sort(long[])) перед вызовом этого метода. Если он не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.- Параметры:
-
a- массив для поиска -
key- искомое значение - Возвращает:
- индекс искомого ключа, если он содержится в массиве; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как точка, в которой ключ был бы вставлен в массив: индекс первого элемента, большего ключа, илиa.length, если все элементы в массиве меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 только в том случае, если ключ найден.
поискДвоичный
public static int binarySearch(long[] a, int fromIndex, int toIndex, long key)
sort(long[], int, int)) перед вызовом этого метода. Если он не отсортирован, результаты не определены. Если поддиапазон содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.- Параметры:
-
a- массив для поиска -
fromIndex- индекс первого элемента (включительно) для поиска -
toIndex- индекс последнего элемента (исключительно) для поиска -
key- искомое значение - Возвращает:
- индекс искомого ключа, если он содержится в массиве в указанном диапазоне; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как точка, в которой ключ был бы вставлен в массив: индекс первого элемента в диапазоне, большего ключа, илиtoIndex, если все элементы в диапазоне меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 только в том случае, если ключ найден. - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0 or toIndex > a.length - С тех пор:
- 1.6
поискДвоичный
public static int binarySearch(int[] a, int key)
sort(int[])) перед вызовом этого метода. Если он не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.- Параметры:
-
a- массив для поиска -
key- искомое значение - Возвращает:
- индекс искомого ключа, если он содержится в массиве; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как точка, в которой ключ был бы вставлен в массив: индекс первого элемента, большего ключа, илиa.length, если все элементы в массиве меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 только в том случае, если ключ найден.
поискДвоичный
public static int binarySearch(int[] a, int fromIndex, int toIndex, int key)
sort(int[], int, int)) перед вызовом этого метода. Если он не отсортирован, результаты не определены. Если поддиапазон содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.- Параметры:
-
a- массив для поиска -
fromIndex- индекс первого элемента (включительно) для поиска -
toIndex- индекс последнего элемента (исключительно) для поиска -
key- искомое значение - Возвращает:
- индекс искомого ключа, если он содержится в массиве в указанном диапазоне; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как точка, в которой ключ был бы вставлен в массив: индекс первого элемента в диапазоне, большего ключа, илиtoIndex, если все элементы в диапазоне меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 только в том случае, если ключ найден. - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0 or toIndex > a.length - С тех пор:
- 1.6
Бинарный поиск
public static int binarySearch(short[] a, short key)
sort(short[])) перед вызовом этого метода. Если массив не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.- Параметры:
-
a- массив для поиска -
key- значение, которое нужно найти - Возвращает:
- индекс ключа поиска, если он содержится в массиве; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, илиa.length, если все элементы в массиве меньше заданного ключа. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.
Бинарный поиск
public static int binarySearch(short[] a, int fromIndex, int toIndex, short key)
sort(short[], int, int)) перед вызовом этого метода. Если диапазон не отсортирован, результаты не определены. Если диапазон содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.- Параметры:
-
a- массив для поиска -
fromIndex- индекс первого элемента (включительно) для поиска -
toIndex- индекс последнего элемента (исключительно) для поиска -
key- значение, которое нужно найти - Возвращает:
- индекс ключа поиска, если он содержится в массиве в указанном диапазоне; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента в диапазоне, большего ключа, илиtoIndex, если все элементы в диапазоне меньше заданного ключа. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден. - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0 or toIndex > a.length - С:
- 1.6
Бинарный поиск
public static int binarySearch(char[] a, char key)
sort(char[])) перед вызовом этого метода. Если массив не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.- Параметры:
-
a- массив для поиска -
key- значение, которое нужно найти - Возвращает:
- индекс ключа поиска, если он содержится в массиве; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, илиa.length, если все элементы в массиве меньше заданного ключа. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.
Бинарный поиск
public static int binarySearch(char[] a, int fromIndex, int toIndex, char key)
sort(char[], int, int)) перед вызовом этого метода. Если диапазон не отсортирован, результаты не определены. Если диапазон содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.- Параметры:
-
a- массив для поиска -
fromIndex- индекс первого элемента (включительно) для поиска -
toIndex- индекс последнего элемента (исключительно) для поиска -
key- значение, которое нужно найти - Возвращает:
- индекс ключа поиска, если он содержится в массиве в указанном диапазоне; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента в диапазоне, большего ключа, илиtoIndex, если все элементы в диапазоне меньше заданного ключа. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден. - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0 or toIndex > a.length - С:
- 1.6
Бинарный поиск
public static int binarySearch(byte[] a, byte key)
sort(byte[])) перед вызовом этого метода. Если массив не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.- Параметры:
-
a- массив для поиска -
key- значение, которое нужно найти - Возвращает:
- индекс ключа поиска, если он содержится в массиве; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, илиa.length, если все элементы в массиве меньше заданного ключа. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.
Бинарный поиск
public static int binarySearch(byte[] a, int fromIndex, int toIndex, byte key)
sort(byte[], int, int)) перед вызовом этого метода. Если диапазон не отсортирован, результаты не определены. Если диапазон содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.- Параметры:
-
a- массив для поиска -
fromIndex- индекс первого элемента (включительно) для поиска -
toIndex- индекс последнего элемента (исключительно) для поиска -
key- значение, которое нужно найти - Возвращает:
- индекс ключа поиска, если он содержится в массиве в указанном диапазоне; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента в диапазоне, большего ключа, илиtoIndex, если все элементы в диапазоне меньше заданного ключа. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден. - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0 or toIndex > a.length - С:
- 1.6
Бинарный поиск
public static int binarySearch(double[] a, double key)
sort(double[])) перед вызовом этого метода. Если массив не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден. Данный метод рассматривает все значения NaN как эквивалентные и равные.- Параметры:
-
a- массив для поиска -
key- значение, которое нужно найти - Возвращает:
- индекс ключа поиска, если он содержится в массиве; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, илиa.length, если все элементы в массиве меньше заданного ключа. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.
Бинарный поиск
public static int binarySearch(double[] a, int fromIndex, int toIndex, double key)
sort(double[], int, int)) перед вызовом этого метода. Если диапазон не отсортирован, результаты не определены. Если диапазон содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден. Данный метод рассматривает все значения NaN как эквивалентные и равные.- Параметры:
-
a- массив для поиска -
fromIndex- индекс первого элемента (включительно) для поиска -
toIndex- индекс последнего элемента (исключительно) для поиска -
key- значение, которое нужно найти - Возвращает:
- индекс ключа поиска, если он содержится в массиве в указанном диапазоне; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента в диапазоне, большего ключа, илиtoIndex, если все элементы в диапазоне меньше заданного ключа. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден. - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0 or toIndex > a.length - С:
- 1.6
Поиск
public static int binarySearch(float[] a, float key)
sort(float[])) перед вызовом этого метода. Если массив не отсортирован, результаты не определены. Если в массиве несколько элементов с указанным значением, нет гарантии, какой из них будет найден. Этот метод рассматривает все значения NaN как эквивалентные и равные.- Параметры:
-
a- искомый массив -
key- значение, которое необходимо найти - Возвращает:
- индекс искомого значения, если оно содержится в массиве; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как точка, в которую искомое значение должно быть вставлено в массив: индекс первого элемента, большего, чем искомое значение, илиa.length, если все элементы в массиве меньше указанного значения. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда искомое значение найдено.
Поиск
public static int binarySearch(float[] a, int fromIndex, int toIndex, float key)
sort(float[], int, int)) перед вызовом этого метода. Если диапазон не отсортирован, результаты не определены. Если в диапазоне несколько элементов с указанным значением, нет гарантии, какой из них будет найден. Этот метод рассматривает все значения NaN как эквивалентные и равные.- Параметры:
-
a- искомый массив -
fromIndex- индекс первого элемента (включительно) для поиска -
toIndex- индекс последнего элемента (исключительно) для поиска -
key- значение, которое необходимо найти - Возвращает:
- индекс искомого значения, если оно содержится в массиве в указанном диапазоне; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как точка, в которую искомое значение должно быть вставлено в массив: индекс первого элемента в диапазоне, большего, чем искомое значение, илиtoIndex, если все элементы в диапазоне меньше указанного значения. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда искомое значение найдено. - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0 or toIndex > a.length - С тех пор:
- 1.6
Поиск
public static int binarySearch(Object[] a, Object key)
sort(Object[])) перед вызовом этого метода. Если массив не отсортирован, результаты не определены. (Если массив содержит элементы, которые не могут быть сравнены между собой (например, строки и целые числа), он *не может* быть отсортирован по естественному порядку элементов, поэтому результаты не определены). Если массив содержит несколько элементов, равных указанному объекту, нет гарантии, какой из них будет найден.- Параметры:
-
a- искомый массив -
key- значение, которое необходимо найти - Возвращает:
- индекс искомого значения, если оно содержится в массиве; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как точка, в которую искомое значение должно быть вставлено в массив: индекс первого элемента, большего, чем искомое значение, илиa.length, если все элементы в массиве меньше указанного значения. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда искомое значение найдено. - Исключения:
-
ClassCastException- если искомый ключ не сравним с элементами массива.
Поиск
public static int binarySearch(Object[] a, int fromIndex, int toIndex, Object key)
sort(Object[], int, int)) перед вызовом этого метода. Если диапазон не отсортирован, результаты не определены. (Если диапазон содержит элементы, которые не могут быть сравнены между собой (например, строки и целые числа), он *не может* быть отсортирован по естественному порядку элементов, поэтому результаты не определены). Если диапазон содержит несколько элементов, равных указанному объекту, нет гарантии, какой из них будет найден.- Параметры:
-
a- искомый массив -
fromIndex- индекс первого элемента (включительно) для поиска -
toIndex- индекс последнего элемента (исключительно) для поиска -
key- значение, которое необходимо найти - Возвращает:
- индекс искомого значения, если оно содержится в массиве в указанном диапазоне; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как точка, в которую искомое значение должно быть вставлено в массив: индекс первого элемента в диапазоне, большего, чем искомое значение, илиtoIndex, если все элементы в диапазоне меньше указанного значения. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда искомое значение найдено. - Исключения:
-
ClassCastException- если искомый ключ не сравним с элементами массива в указанном диапазоне. -
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0 or toIndex > a.length - С тех пор:
- 1.6
Поиск
public static <T> int binarySearch(T[] a, T key, Comparator<? super T> c)
sort(T[], Comparator)) перед вызовом этого метода. Если массив не отсортирован, результаты не определены. Если массив содержит несколько элементов, равных указанному объекту, нет гарантии, какой из них будет найден.- Тип параметров:
-
T- класс объектов в массиве - Параметры:
-
a- искомый массив -
key- значение, которое необходимо найти -
c- компаратор, по которому отсортирован массив. Значениеnullуказывает, что следует использовать естественный порядок элементов. - Возвращает:
- индекс искомого значения, если оно содержится в массиве; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как точка, в которую искомое значение должно быть вставлено в массив: индекс первого элемента, большего, чем искомое значение, илиa.length, если все элементы в массиве меньше указанного значения. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда искомое значение найдено. - Исключения:
-
ClassCastException- если массив содержит элементы, которые не могут быть сравнены друг с другом с помощью указанного компаратора, или искомое значение не сравнимо с элементами массива с помощью этого компаратора.
Поиск
public static <T> int binarySearch(T[] a, int fromIndex, int toIndex, T key, Comparator<? super T> c)
sort(T[], int, int, Comparator)) перед вызовом этого метода. Если диапазон не отсортирован, результаты не определены. Если диапазон содержит несколько элементов, равных указанному объекту, нет гарантии, какой из них будет найден.- Тип параметров:
-
T- класс объектов в массиве - Параметры:
-
a- искомый массив -
fromIndex- индекс первого элемента (включительно) для поиска -
toIndex- индекс последнего элемента (исключительно) для поиска -
key- значение, которое необходимо найти -
c- компаратор, по которому отсортирован массив. Значениеnullуказывает, что следует использовать естественный порядок элементов. - Возвращает:
- индекс искомого значения, если оно содержится в массиве в указанном диапазоне; в противном случае,
(-(insertion point) - 1). Точка вставки определяется как точка, в которую искомое значение должно быть вставлено в массив: индекс первого элемента в диапазоне, большего, чем искомое значение, илиtoIndex, если все элементы в диапазоне меньше указанного значения. Обратите внимание, что это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда искомое значение найдено. - Исключения:
-
ClassCastException- если диапазон содержит элементы, которые не могут быть сравнены друг с другом с помощью указанного компаратора, или искомое значение не сравнимо с элементами в диапазоне с помощью этого компаратора. -
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0 or toIndex > a.length - С тех пор:
- 1.6
equals
public static boolean equals(long[] a, long[] a2)
true, если два заданных массива long равны друг другу. Два массива считаются равными, если оба массива содержат одинаковое количество элементов и все соответствующие пары элементов в двух массивах равны. Другими словами, два массива равны, если они содержат одинаковые элементы в том же порядке. Кроме того, две ссылки на массив считаются равными, если обе являются null.- Parameters:
-
a- один массив, проверяемый на равенство -
a2- другой массив, проверяемый на равенство - Returns:
-
true, если два массива равны
equals
public static boolean equals(long[] a, int aFromIndex, int aToIndex, long[] b, int bFromIndex, int bToIndex)
Два массива считаются равными, если количество элементов, охватываемых каждым диапазоном, одинаково, и все соответствующие пары элементов в двух массивах в заданных диапазонах равны. Другими словами, два массива равны, если они содержат в заданных диапазонах одинаковые элементы в том же порядке.
- Parameters:
-
a- первый массив, проверяемый на равенство -
aFromIndex- индекс (включительно) первого элемента в первом массиве, который будет проверен -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, который будет проверен -
b- второй массив, проверяемый на равенство -
bFromIndex- индекс (включительно) первого элемента во втором массиве, который будет проверен -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, который будет проверен - Returns:
-
true, если два массива в заданных диапазонах равны - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов являетсяnull - Since:
- 9
equals
public static boolean equals(int[] a, int[] a2)
true, если два заданных массива int равны друг другу. Два массива считаются равными, если оба массива содержат одинаковое количество элементов и все соответствующие пары элементов в двух массивах равны. Другими словами, два массива равны, если они содержат одинаковые элементы в том же порядке. Кроме того, две ссылки на массив считаются равными, если обе являются null.- Parameters:
-
a- один массив, проверяемый на равенство -
a2- другой массив, проверяемый на равенство - Returns:
-
true, если два массива равны
equals
public static boolean equals(int[] a, int aFromIndex, int aToIndex, int[] b, int bFromIndex, int bToIndex)
Два массива считаются равными, если количество элементов, охватываемых каждым диапазоном, одинаково, и все соответствующие пары элементов в двух массивах в заданных диапазонах равны. Другими словами, два массива равны, если они содержат в заданных диапазонах одинаковые элементы в том же порядке.
- Parameters:
-
a- первый массив, проверяемый на равенство -
aFromIndex- индекс (включительно) первого элемента в первом массиве, который будет проверен -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, который будет проверен -
b- второй массив, проверяемый на равенство -
bFromIndex- индекс (включительно) первого элемента во втором массиве, который будет проверен -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, который будет проверен - Returns:
-
true, если два массива в заданных диапазонах равны - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов являетсяnull - Since:
- 9
equals
public static boolean equals(short[] a, short[] a2)
true, если два заданных массива short равны друг другу. Два массива считаются равными, если оба массива содержат одинаковое количество элементов и все соответствующие пары элементов в двух массивах равны. Другими словами, два массива равны, если они содержат одинаковые элементы в том же порядке. Кроме того, две ссылки на массив считаются равными, если обе являются null.- Parameters:
-
a- один массив, проверяемый на равенство -
a2- другой массив, проверяемый на равенство - Returns:
-
true, если два массива равны
equals
public static boolean equals(short[] a, int aFromIndex, int aToIndex, short[] b, int bFromIndex, int bToIndex)
Два массива считаются равными, если количество элементов, охватываемых каждым диапазоном, одинаково, и все соответствующие пары элементов в двух массивах в заданных диапазонах равны. Другими словами, два массива равны, если они содержат в заданных диапазонах одинаковые элементы в том же порядке.
- Parameters:
-
a- первый массив, проверяемый на равенство -
aFromIndex- индекс (включительно) первого элемента в первом массиве, который будет проверен -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, который будет проверен -
b- второй массив, проверяемый на равенство -
bFromIndex- индекс (включительно) первого элемента во втором массиве, который будет проверен -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, который будет проверен - Returns:
-
true, если два массива в заданных диапазонах равны - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов являетсяnull - Since:
- 9
equals
public static boolean equals(char[] a, char[] a2)
true, если два заданных массива char равны друг другу. Два массива считаются равными, если оба массива содержат одинаковое количество элементов и все соответствующие пары элементов в двух массивах равны. Другими словами, два массива равны, если они содержат одинаковые элементы в том же порядке. Кроме того, две ссылки на массив считаются равными, если обе являются null.- Parameters:
-
a- один массив, проверяемый на равенство -
a2- другой массив, проверяемый на равенство - Returns:
-
true, если два массива равны
equals
public static boolean equals(char[] a, int aFromIndex, int aToIndex, char[] b, int bFromIndex, int bToIndex)
Два массива считаются равными, если количество элементов, охватываемых каждым диапазоном, одинаково, и все соответствующие пары элементов в двух массивах в заданных диапазонах равны. Другими словами, два массива равны, если они содержат в заданных диапазонах одинаковые элементы в том же порядке.
- Parameters:
-
a- первый массив, проверяемый на равенство -
aFromIndex- индекс (включительно) первого элемента в первом массиве, который будет проверен -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, который будет проверен -
b- второй массив, проверяемый на равенство -
bFromIndex- индекс (включительно) первого элемента во втором массиве, который будет проверен -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, который будет проверен - Returns:
-
true, если два массива в заданных диапазонах равны - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов являетсяnull - Since:
- 9
equals
public static boolean equals(byte[] a, byte[] a2)
true, если два заданных массива байтов равны друг другу. Два массива считаются равными, если оба массива содержат одинаковое количество элементов и все соответствующие пары элементов в двух массивах равны. Другими словами, два массива равны, если они содержат одинаковые элементы в том же порядке. Кроме того, две ссылки на массив считаются равными, если обе являются null.- Parameters:
-
a- один массив, проверяемый на равенство -
a2- другой массив, проверяемый на равенство - Returns:
-
true, если два массива равны
equals
public static boolean equals(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex)
Два массива считаются равными, если количество элементов, покрываемых каждым диапазоном, одинаково, и все соответствующие пары элементов в указанных диапазонах в двух массивах равны. Другими словами, два массива равны, если они содержат в указанных диапазонах одни и те же элементы в том же порядке.
- Parameters:
-
a- первый массив, проверяемый на равенство -
aFromIndex- индекс (включительно) первого элемента в первом массиве, подлежащего проверке -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, подлежащего проверке -
b- второй массив, проверяемый на равенство -
bFromIndex- индекс (включительно) первого элемента во втором массиве, подлежащего проверке -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, подлежащего проверке - Returns:
-
true, если два массива в указанных диапазонах равны - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - Since:
- 9
equals
public static boolean equals(boolean[] a, boolean[] a2)
true, если два указанных массива булевых значений равны друг другу. Два массива считаются равными, если оба массива содержат одинаковое количество элементов и все соответствующие пары элементов в двух массивах равны. Другими словами, два массива равны, если они содержат одни и те же элементы в том же порядке. Также две ссылки на массивы считаются равными, если обе являются null.- Parameters:
-
a- один массив, проверяемый на равенство -
a2- другой массив, проверяемый на равенство - Returns:
-
true, если два массива равны
equals
public static boolean equals(boolean[] a, int aFromIndex, int aToIndex, boolean[] b, int bFromIndex, int bToIndex)
Два массива считаются равными, если количество элементов, покрываемых каждым диапазоном, одинаково, и все соответствующие пары элементов в указанных диапазонах в двух массивах равны. Другими словами, два массива равны, если они содержат в указанных диапазонах одни и те же элементы в том же порядке.
- Parameters:
-
a- первый массив, проверяемый на равенство -
aFromIndex- индекс (включительно) первого элемента в первом массиве, подлежащего проверке -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, подлежащего проверке -
b- второй массив, проверяемый на равенство -
bFromIndex- индекс (включительно) первого элемента во втором массиве, подлежащего проверке -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, подлежащего проверке - Returns:
-
true, если два массива в указанных диапазонах равны - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - Since:
- 9
equals
public static boolean equals(double[] a, double[] a2)
true, если два указанных массива значений типа double равны друг другу. Два массива считаются равными, если оба массива содержат одинаковое количество элементов и все соответствующие пары элементов в двух массивах равны. Другими словами, два массива равны, если они содержат одни и те же элементы в том же порядке. Также две ссылки на массивы считаются равными, если обе являются null. Два значения типа double d1 и d2 считаются равными, если: new Double(d1).equals(new Double(d2)) (В отличие от оператора ==, этот метод считает NaN равным самому себе, а 0.0d не равным -0.0d.)- Parameters:
-
a- один массив, проверяемый на равенство -
a2- другой массив, проверяемый на равенство - Returns:
-
true, если два массива равны - See Also:
equals
public static boolean equals(double[] a, int aFromIndex, int aToIndex, double[] b, int bFromIndex, int bToIndex)
Два массива считаются равными, если количество элементов, покрываемых каждым диапазоном, одинаково, и все соответствующие пары элементов в указанных диапазонах в двух массивах равны. Другими словами, два массива равны, если они содержат в указанных диапазонах одни и те же элементы в том же порядке.
Два значения типа double d1 и d2 считаются равными, если:
new Double(d1).equals(new Double(d2)) (В отличие от оператора ==, этот метод считает NaN равным самому себе, а 0.0d не равным -0.0d.)- Parameters:
-
a- первый массив, проверяемый на равенство -
aFromIndex- индекс (включительно) первого элемента в первом массиве, подлежащего проверке -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, подлежащего проверке -
b- второй массив, проверяемый на равенство -
bFromIndex- индекс (включительно) первого элемента во втором массиве, подлежащего проверке -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, подлежащего проверке - Returns:
-
true, если два массива в указанных диапазонах равны - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - Since:
- 9
- See Also:
equals
public static boolean equals(float[] a, float[] a2)
true, если два указанных массива значений типа float равны друг другу. Два массива считаются равными, если оба массива содержат одинаковое количество элементов и все соответствующие пары элементов в двух массивах равны. Другими словами, два массива равны, если они содержат одни и те же элементы в том же порядке. Также две ссылки на массивы считаются равными, если обе являются null. Два значения типа float f1 и f2 считаются равными, если: new Float(f1).equals(new Float(f2)) (В отличие от оператора ==, этот метод считает NaN равным самому себе, а 0.0f не равным -0.0f.)- Parameters:
-
a- один массив, проверяемый на равенство -
a2- другой массив, проверяемый на равенство - Returns:
-
true, если два массива равны - See Also:
equals
public static boolean equals(float[] a, int aFromIndex, int aToIndex, float[] b, int bFromIndex, int bToIndex)
Два массива считаются равными, если количество элементов, покрываемых каждым диапазоном, одинаково, и все соответствующие пары элементов в указанных диапазонах в двух массивах равны. Другими словами, два массива равны, если они содержат в указанных диапазонах одни и те же элементы в том же порядке.
Два значения типа float f1 и f2 считаются равными, если:
new Float(f1).equals(new Float(f2)) (В отличие от оператора ==, этот метод считает NaN равным самому себе, а 0.0f не равным -0.0f.)- Parameters:
-
a- первый массив, проверяемый на равенство -
aFromIndex- индекс (включительно) первого элемента в первом массиве, подлежащего проверке -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, подлежащего проверке -
b- второй массив, проверяемый на равенство -
bFromIndex- индекс (включительно) первого элемента во втором массиве, подлежащего проверке -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, подлежащего проверке - Returns:
-
true, если два массива в указанных диапазонах равны - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - Since:
- 9
- See Also:
equals
public static boolean equals(Object[] a, Object[] a2)
true, если два указанных массива объектов равны друг другу. Два массива считаются равными, если оба массива содержат одинаковое количество элементов и все соответствующие пары элементов в двух массивах равны. Два объекта e1 и e2 считаются равными, если Objects.equals(e1, e2). Другими словами, два массива равны, если они содержат одни и те же элементы в том же порядке. Также две ссылки на массивы считаются равными, если обе являются null.- Parameters:
-
a- один массив, который нужно проверить на равенство -
a2- другой массив, который нужно проверить на равенство - Returns:
-
true, если два массива равны
equals
public static boolean equals(Object[] a, int aFromIndex, int aToIndex, Object[] b, int bFromIndex, int bToIndex)
Два массива считаются равными, если количество элементов, покрытых каждым диапазоном, одинаково, и все соответствующие пары элементов в указанных диапазонах в двух массивах равны. Другими словами, два массива равны, если они содержат в указанных диапазонах одни и те же элементы в том же порядке.
Два объекта e1 и e2 считаются равными, если Objects.equals(e1, e2).
- Parameters:
-
a- первый массив, который нужно проверить на равенство -
aFromIndex- индекс (включительно) первого элемента в первом массиве, который нужно проверить -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, который нужно проверить -
b- второй массив, который нужно проверить на равенство -
bFromIndex- индекс (включительно) первого элемента во втором массиве, который нужно проверить -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, который нужно проверить - Returns:
-
true, если два массива в указанных диапазонах равны - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов являетсяnull - Since:
- 9
equals
public static <T> boolean equals(T[] a, T[] a2, Comparator<? super T> cmp)
true, если два указанных массива объектов равны друг другу. Два массива считаются равными, если оба массива содержат одинаковое количество элементов и все соответствующие пары элементов в двух массивах равны. Другими словами, два массива равны, если они содержат одни и те же элементы в том же порядке. Также две ссылки на массивы считаются равными, если обе являются null.
Два объекта e1 и e2 считаются равными, если, учитывая указанный компаратор, cmp.compare(e1, e2) == 0.
- Type Parameters:
-
T- тип элементов массива - Parameters:
-
a- один массив, который нужно проверить на равенство -
a2- другой массив, который нужно проверить на равенство -
cmp- компаратор для сравнения элементов массива - Returns:
-
true, если два массива равны - Throws:
-
NullPointerException- если компаратор являетсяnull - Since:
- 9
equals
public static <T> boolean equals(T[] a, int aFromIndex, int aToIndex, T[] b, int bFromIndex, int bToIndex, Comparator<? super T> cmp)
Два массива считаются равными, если количество элементов, покрытых каждым диапазоном, одинаково, и все соответствующие пары элементов в указанных диапазонах в двух массивах равны. Другими словами, два массива равны, если они содержат в указанных диапазонах одни и те же элементы в том же порядке.
Два объекта e1 и e2 считаются равными, если, учитывая указанный компаратор, cmp.compare(e1, e2) == 0.
- Type Parameters:
-
T- тип элементов массива - Parameters:
-
a- первый массив, который нужно проверить на равенство -
aFromIndex- индекс (включительно) первого элемента в первом массиве, который нужно проверить -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, который нужно проверить -
b- второй массив, который нужно проверить на равенство -
bFromIndex- индекс (включительно) первого элемента во втором массиве, который нужно проверить -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, который нужно проверить -
cmp- компаратор для сравнения элементов массива - Returns:
-
true, если два массива в указанных диапазонах равны - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов или компаратор являетсяnull - Since:
- 9
fill
public static void fill(long[] a, long val)
- Parameters:
-
a- массив, который нужно заполнить -
val- значение, которое нужно сохранить во всех элементах массива
fill
public static void fill(long[] a, int fromIndex, int toIndex, long val)
fromIndex, включительно, до индекса toIndex, исключая его. (Если fromIndex==toIndex, диапазон, который нужно заполнить, пуст.)- Parameters:
-
a- массив, который нужно заполнить -
fromIndex- индекс первого элемента (включительно), который нужно заполнить указанным значением -
toIndex- индекс последнего элемента (исключительно), который нужно заполнить указанным значением -
val- значение, которое нужно сохранить во всех элементах массива - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
fill
public static void fill(int[] a, int val)
- Parameters:
-
a- массив, который нужно заполнить -
val- значение, которое нужно сохранить во всех элементах массива
fill
public static void fill(int[] a, int fromIndex, int toIndex, int val)
fromIndex, включительно, до индекса toIndex, исключая его. (Если fromIndex==toIndex, диапазон, который нужно заполнить, пуст.)- Parameters:
-
a- массив, который нужно заполнить -
fromIndex- индекс первого элемента (включительно), который нужно заполнить указанным значением -
toIndex- индекс последнего элемента (исключительно), который нужно заполнить указанным значением -
val- значение, которое нужно сохранить во всех элементах массива - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
fill
public static void fill(short[] a, short val)
- Parameters:
-
a- массив, который нужно заполнить -
val- значение, которое нужно сохранить во всех элементах массива
fill
public static void fill(short[] a, int fromIndex, int toIndex, short val)
fromIndex, включительно, до индекса toIndex, исключая его. (Если fromIndex==toIndex, диапазон, который нужно заполнить, пуст.)- Parameters:
-
a- массив, который нужно заполнить -
fromIndex- индекс первого элемента (включительно), который нужно заполнить указанным значением -
toIndex- индекс последнего элемента (исключительно), который нужно заполнить указанным значением -
val- значение, которое нужно сохранить во всех элементах массива - Throws:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
fill
public static void fill(char[] a, char val)
- Parameters:
-
a- массив, который нужно заполнить -
val- значение, которое нужно сохранить во всех элементах массива
fill
public static void fill(char[] a, int fromIndex, int toIndex, char val)
fromIndex включительно до индекса toIndex, не включая его. (Если fromIndex==toIndex, заполняемый диапазон пуст.)- Параметры:
-
a- массив для заполнения -
fromIndex- индекс первого элемента (включительно), который будет заполнен указанным значением -
toIndex- индекс последнего элемента (исключительно), который будет заполнен указанным значением -
val- значение, которое будет храниться во всех элементах массива - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
fill
public static void fill(byte[] a, byte val)
- Параметры:
-
a- массив для заполнения -
val- значение, которое будет храниться во всех элементах массива
fill
public static void fill(byte[] a, int fromIndex, int toIndex, byte val)
fromIndex включительно до индекса toIndex, не включая его. (Если fromIndex==toIndex, заполняемый диапазон пуст.)- Параметры:
-
a- массив для заполнения -
fromIndex- индекс первого элемента (включительно), который будет заполнен указанным значением -
toIndex- индекс последнего элемента (исключительно), который будет заполнен указанным значением -
val- значение, которое будет храниться во всех элементах массива - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
fill
public static void fill(boolean[] a, boolean val)
- Параметры:
-
a- массив для заполнения -
val- значение, которое будет храниться во всех элементах массива
fill
public static void fill(boolean[] a, int fromIndex, int toIndex, boolean val)
fromIndex включительно до индекса toIndex, не включая его. (Если fromIndex==toIndex, заполняемый диапазон пуст.)- Параметры:
-
a- массив для заполнения -
fromIndex- индекс первого элемента (включительно), который будет заполнен указанным значением -
toIndex- индекс последнего элемента (исключительно), который будет заполнен указанным значением -
val- значение, которое будет храниться во всех элементах массива - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
fill
public static void fill(double[] a, double val)
- Параметры:
-
a- массив для заполнения -
val- значение, которое будет храниться во всех элементах массива
fill
public static void fill(double[] a, int fromIndex, int toIndex, double val)
fromIndex включительно до индекса toIndex, не включая его. (Если fromIndex==toIndex, заполняемый диапазон пуст.)- Параметры:
-
a- массив для заполнения -
fromIndex- индекс первого элемента (включительно), который будет заполнен указанным значением -
toIndex- индекс последнего элемента (исключительно), который будет заполнен указанным значением -
val- значение, которое будет храниться во всех элементах массива - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
fill
public static void fill(float[] a, float val)
- Параметры:
-
a- массив для заполнения -
val- значение, которое будет храниться во всех элементах массива
fill
public static void fill(float[] a, int fromIndex, int toIndex, float val)
fromIndex включительно до индекса toIndex, не включая его. (Если fromIndex==toIndex, заполняемый диапазон пуст.)- Параметры:
-
a- массив для заполнения -
fromIndex- индекс первого элемента (включительно), который будет заполнен указанным значением -
toIndex- индекс последнего элемента (исключительно), который будет заполнен указанным значением -
val- значение, которое будет храниться во всех элементах массива - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length
fill
public static void fill(Object[] a, Object val)
- Параметры:
-
a- массив для заполнения -
val- значение, которое будет храниться во всех элементах массива - Исключения:
-
ArrayStoreException- если указанное значение не имеет типа времени выполнения, который может быть сохранен в указанном массиве
fill
public static void fill(Object[] a, int fromIndex, int toIndex, Object val)
fromIndex включительно до индекса toIndex, не включая его. (Если fromIndex==toIndex, заполняемый диапазон пуст.)- Параметры:
-
a- массив для заполнения -
fromIndex- индекс первого элемента (включительно), который будет заполнен указанным значением -
toIndex- индекс последнего элемента (исключительно), который будет заполнен указанным значением -
val- значение, которое будет храниться во всех элементах массива - Исключения:
-
IllegalArgumentException- еслиfromIndex > toIndex -
ArrayIndexOutOfBoundsException- еслиfromIndex < 0илиtoIndex > a.length -
ArrayStoreException- если указанное значение не имеет типа времени выполнения, который может быть сохранен в указанном массиве
copyOf
public static <T> T[] copyOf(T[] original, int newLength)
null. Такие индексы будут существовать тогда и только тогда, когда указанная длина больше, чем длина исходного массива. Результирующий массив имеет точно такой же класс, как и исходный массив.- Параметры типа:
-
T- класс объектов в массиве - Параметры:
-
original- массив для копирования -
newLength- длина возвращаемой копии - Возвращает:
- копию исходного массива, усеченную или дополненную нулями для получения указанной длины
- Исключения:
-
NegativeArraySizeException- еслиnewLengthотрицательно -
NullPointerException- еслиoriginalравно null - С версии:
- 1.6
copyOf
public static <T, U> T[] copyOf(U[] original, int newLength, Class<? extends T[]> newType)
null. Такие индексы будут существовать тогда и только тогда, когда указанная длина больше, чем длина исходного массива. Результирующий массив имеет класс newType.- Параметры типа:
-
U- класс объектов в исходном массиве -
T- класс объектов в возвращаемом массиве - Параметры:
-
original- массив для копирования -
newLength- длина возвращаемой копии -
newType- класс возвращаемой копии - Возвращает:
- копию исходного массива, усеченную или дополненную нулями для получения указанной длины
- Исключения:
-
NegativeArraySizeException- еслиnewLengthотрицательно -
NullPointerException- еслиoriginalравно null -
ArrayStoreException- если элемент, скопированный изoriginal, не имеет типа времени выполнения, который может быть сохранен в массиве классаnewType - С версии:
- 1.6
копия
public static byte[] copyOf(byte[] original, int newLength)
(byte)0. Такие индексы существуют только в том случае, если указанная длина больше длины исходного массива.- Параметры:
-
original- массив, который нужно скопировать -
newLength- длина возвращаемой копии - Возвращает:
- копию исходного массива, обрезая или заполняя нулями, чтобы получить указанную длину
- Исключения:
-
NegativeArraySizeException- еслиnewLengthотрицательно -
NullPointerException- еслиoriginalравно null - С:
- 1.6
копия
public static short[] copyOf(short[] original, int newLength)
(short)0. Такие индексы существуют только в том случае, если указанная длина больше длины исходного массива.- Параметры:
-
original- массив, который нужно скопировать -
newLength- длина возвращаемой копии - Возвращает:
- копию исходного массива, обрезая или заполняя нулями, чтобы получить указанную длину
- Исключения:
-
NegativeArraySizeException- еслиnewLengthотрицательно -
NullPointerException- еслиoriginalравно null - С:
- 1.6
копия
public static int[] copyOf(int[] original, int newLength)
0. Такие индексы существуют только в том случае, если указанная длина больше длины исходного массива.- Параметры:
-
original- массив, который нужно скопировать -
newLength- длина возвращаемой копии - Возвращает:
- копию исходного массива, обрезая или заполняя нулями, чтобы получить указанную длину
- Исключения:
-
NegativeArraySizeException- еслиnewLengthотрицательно -
NullPointerException- еслиoriginalравно null - С:
- 1.6
копия
public static long[] copyOf(long[] original, int newLength)
0L. Такие индексы существуют только в том случае, если указанная длина больше длины исходного массива.- Параметры:
-
original- массив, который нужно скопировать -
newLength- длина возвращаемой копии - Возвращает:
- копию исходного массива, обрезая или заполняя нулями, чтобы получить указанную длину
- Исключения:
-
NegativeArraySizeException- еслиnewLengthотрицательно -
NullPointerException- еслиoriginalравно null - С:
- 1.6
копия
public static char[] copyOf(char[] original, int newLength)
'\u0000'. Такие индексы существуют только в том случае, если указанная длина больше длины исходного массива.- Параметры:
-
original- массив, который нужно скопировать -
newLength- длина возвращаемой копии - Возвращает:
- копию исходного массива, обрезая или заполняя нулевыми символами, чтобы получить указанную длину
- Исключения:
-
NegativeArraySizeException- еслиnewLengthотрицательно -
NullPointerException- еслиoriginalравно null - С:
- 1.6
копия
public static float[] copyOf(float[] original, int newLength)
0f. Такие индексы существуют только в том случае, если указанная длина больше длины исходного массива.- Параметры:
-
original- массив, который нужно скопировать -
newLength- длина возвращаемой копии - Возвращает:
- копию исходного массива, обрезая или заполняя нулями, чтобы получить указанную длину
- Исключения:
-
NegativeArraySizeException- еслиnewLengthотрицательно -
NullPointerException- еслиoriginalравно null - С:
- 1.6
копия
public static double[] copyOf(double[] original, int newLength)
0d. Такие индексы существуют только в том случае, если указанная длина больше длины исходного массива.- Параметры:
-
original- массив, который нужно скопировать -
newLength- длина возвращаемой копии - Возвращает:
- копию исходного массива, обрезая или заполняя нулями, чтобы получить указанную длину
- Исключения:
-
NegativeArraySizeException- еслиnewLengthотрицательно -
NullPointerException- еслиoriginalравно null - С:
- 1.6
копия
public static boolean[] copyOf(boolean[] original, int newLength)
false (если необходимо), чтобы копия имела указанную длину. Для всех индексов, которые являются допустимыми как в исходном массиве, так и в копии, оба массива будут содержать одинаковые значения. Для любых индексов, которые являются допустимыми в копии, но не в исходном массиве, копия будет содержать false. Такие индексы существуют только в том случае, если указанная длина больше длины исходного массива.- Параметры:
-
original- массив, который нужно скопировать -
newLength- длина возвращаемой копии - Возвращает:
- копию исходного массива, обрезая или заполняя ложными элементами, чтобы получить указанную длину
- Исключения:
-
NegativeArraySizeException- еслиnewLengthотрицательно -
NullPointerException- еслиoriginalравно null - С:
- 1.6
копияДиапазона
public static <T> T[] copyOfRange(T[] original, int from, int to)
from) должен лежать между нулем и original.length включительно. Значение по адресу original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае null помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from. Возвращаемый массив имеет ровно тот же класс, что и исходный массив.
- Параметры типа:
-
T- класс объектов в массиве - Параметры:
-
original- массив, из которого нужно скопировать диапазон -
from- начальный индекс копируемого диапазона, включительно -
to- конечный индекс копируемого диапазона, исключая его. (Этот индекс может лежать вне массива.) - Возвращает:
- новый массив, содержащий указанный диапазон из исходного массива, обрезанный или заполненный нулями для получения необходимой длины
- Исключения:
-
ArrayIndexOutOfBoundsException- еслиfrom < 0илиfrom > original.length -
IllegalArgumentException- еслиfrom > to -
NullPointerException- еслиoriginalравно null - С:
- 1.6
copyOfRange
public static <T, U> T[] copyOfRange(U[] original, int from, int to, Class<? extends T[]> newType)
from) должен лежать между нулём и original.length включительно. Значение в позиции original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае null помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from. Результирующий массив принадлежит классу newType.- Type Parameters:
-
U- класс объектов в исходном массиве -
T- класс объектов в возвращаемом массиве - Parameters:
-
original- массив, из которого копируется диапазон -
from- начальный индекс копируемого диапазона, включительно -
to- конечный индекс копируемого диапазона, исключая его. (Этот индекс может лежать вне массива.) -
newType- класс возвращаемой копии - Returns:
- новый массив, содержащий указанный диапазон из исходного массива, усечённый или заполненный значениями null для получения требуемой длины
- Throws:
-
ArrayIndexOutOfBoundsException- еслиfrom < 0илиfrom > original.length -
IllegalArgumentException- еслиfrom > to -
NullPointerException- еслиoriginalимеет значение null -
ArrayStoreException- если элемент, скопированный изoriginal, не является типом runtime, который может храниться в массиве классаnewType. - Since:
- 1.6
copyOfRange
public static byte[] copyOfRange(byte[] original, int from, int to)
from) должен лежать между нулём и original.length включительно. Значение в позиции original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае (byte)0 помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.- Parameters:
-
original- массив, из которого копируется диапазон -
from- начальный индекс копируемого диапазона, включительно -
to- конечный индекс копируемого диапазона, исключая его. (Этот индекс может лежать вне массива.) - Returns:
- новый массив, содержащий указанный диапазон из исходного массива, усечённый или заполненный нулями для получения требуемой длины
- Throws:
-
ArrayIndexOutOfBoundsException- еслиfrom < 0илиfrom > original.length -
IllegalArgumentException- еслиfrom > to -
NullPointerException- еслиoriginalимеет значение null - Since:
- 1.6
copyOfRange
public static short[] copyOfRange(short[] original, int from, int to)
from) должен лежать между нулём и original.length включительно. Значение в позиции original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае (short)0 помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.- Parameters:
-
original- массив, из которого копируется диапазон -
from- начальный индекс копируемого диапазона, включительно -
to- конечный индекс копируемого диапазона, исключая его. (Этот индекс может лежать вне массива.) - Returns:
- новый массив, содержащий указанный диапазон из исходного массива, усечённый или заполненный нулями для получения требуемой длины
- Throws:
-
ArrayIndexOutOfBoundsException- еслиfrom < 0илиfrom > original.length -
IllegalArgumentException- еслиfrom > to -
NullPointerException- еслиoriginalимеет значение null - Since:
- 1.6
copyOfRange
public static int[] copyOfRange(int[] original, int from, int to)
from) должен лежать между нулём и original.length включительно. Значение в позиции original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае 0 помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.- Parameters:
-
original- массив, из которого копируется диапазон -
from- начальный индекс копируемого диапазона, включительно -
to- конечный индекс копируемого диапазона, исключая его. (Этот индекс может лежать вне массива.) - Returns:
- новый массив, содержащий указанный диапазон из исходного массива, усечённый или заполненный нулями для получения требуемой длины
- Throws:
-
ArrayIndexOutOfBoundsException- еслиfrom < 0илиfrom > original.length -
IllegalArgumentException- еслиfrom > to -
NullPointerException- еслиoriginalимеет значение null - Since:
- 1.6
copyOfRange
public static long[] copyOfRange(long[] original, int from, int to)
from) должен лежать между нулём и original.length включительно. Значение в позиции original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае 0L помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.- Parameters:
-
original- массив, из которого копируется диапазон -
from- начальный индекс копируемого диапазона, включительно -
to- конечный индекс копируемого диапазона, исключая его. (Этот индекс может лежать вне массива.) - Returns:
- новый массив, содержащий указанный диапазон из исходного массива, усечённый или заполненный нулями для получения требуемой длины
- Throws:
-
ArrayIndexOutOfBoundsException- еслиfrom < 0илиfrom > original.length -
IllegalArgumentException- еслиfrom > to -
NullPointerException- еслиoriginalимеет значение null - Since:
- 1.6
copyOfRange
public static char[] copyOfRange(char[] original, int from, int to)
from) должен лежать между нулём и original.length включительно. Значение в позиции original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае '\u0000' помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.- Parameters:
-
original- массив, из которого копируется диапазон -
from- начальный индекс копируемого диапазона, включительно -
to- конечный индекс копируемого диапазона, исключая его. (Этот индекс может лежать вне массива.) - Returns:
- новый массив, содержащий указанный диапазон из исходного массива, усечённый или заполненный нулевыми символами для получения требуемой длины
- Throws:
-
ArrayIndexOutOfBoundsException- еслиfrom < 0илиfrom > original.length -
IllegalArgumentException- еслиfrom > to -
NullPointerException- еслиoriginalимеет значение null - Since:
- 1.6
copyOfRange
public static float[] copyOfRange(float[] original, int from, int to)
from) должен лежать между нулём и original.length включительно. Значение по адресу original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае 0f помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.- Parameters:
-
original- массив, из которого копируется диапазон -
from- начальный индекс копируемого диапазона, включительно -
to- конечный индекс копируемого диапазона, не включительно. (Этот индекс может лежать вне массива.) - Returns:
- новый массив, содержащий указанный диапазон из исходного массива, усечённый или дополненный нулями для получения необходимой длины
- Throws:
-
ArrayIndexOutOfBoundsException- еслиfrom < 0илиfrom > original.length -
IllegalArgumentException- еслиfrom > to -
NullPointerException- еслиoriginalравен null - Since:
- 1.6
copyOfRange
public static double[] copyOfRange(double[] original, int from, int to)
from) должен лежать между нулём и original.length включительно. Значение по адресу original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае 0d помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.- Parameters:
-
original- массив, из которого копируется диапазон -
from- начальный индекс копируемого диапазона, включительно -
to- конечный индекс копируемого диапазона, не включительно. (Этот индекс может лежать вне массива.) - Returns:
- новый массив, содержащий указанный диапазон из исходного массива, усечённый или дополненный нулями для получения необходимой длины
- Throws:
-
ArrayIndexOutOfBoundsException- еслиfrom < 0илиfrom > original.length -
IllegalArgumentException- еслиfrom > to -
NullPointerException- еслиoriginalравен null - Since:
- 1.6
copyOfRange
public static boolean[] copyOfRange(boolean[] original, int from, int to)
from) должен лежать между нулём и original.length включительно. Значение по адресу original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае false помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.- Parameters:
-
original- массив, из которого копируется диапазон -
from- начальный индекс копируемого диапазона, включительно -
to- конечный индекс копируемого диапазона, не включительно. (Этот индекс может лежать вне массива.) - Returns:
- новый массив, содержащий указанный диапазон из исходного массива, усечённый или дополненный ложными значениями для получения необходимой длины
- Throws:
-
ArrayIndexOutOfBoundsException- еслиfrom < 0илиfrom > original.length -
IllegalArgumentException- еслиfrom > to -
NullPointerException- еслиoriginalравен null - Since:
- 1.6
asList
@SafeVarargs public static <T> List<T> asList(T... a)
Serializable и реализует RandomAccess. Возвращаемый список реализует необязательные Collection методы, за исключением тех, которые изменяют размер возвращаемого списка. Эти методы оставляют список неизменным и выбрасывают UnsupportedOperationException.
- API Note:
- Этот метод действует как мост между основанными на массивах и основанными на коллекциях API, в сочетании с
Collection.toArray().Этот метод предоставляет способ обернуть существующий массив:
Integer[] numbers = ... ... List<Integer> values = Arrays.asList(numbers);Этот метод также предоставляет удобный способ создания списка фиксированного размера, инициализированного несколькими элементами:
List<String> stooges = Arrays.asList("Larry", "Moe", "Curly");Возвращаемый этим методом список изменяемый. Для создания неизменяемого списка используйте
Collections.unmodifiableListили Неизменяемые списки. - Type Parameters:
-
T- класс объектов в массиве - Parameters:
-
a- массив, которым будет поддерживаться список - Returns:
- вид списка указанного массива
- Throws:
-
NullPointerException- если указанный массивnull
hashCode
public static int hashCode(long[] a)
long массивов a и b, таких, что Arrays.equals(a, b), также верно, что Arrays.hashCode(a) == Arrays.hashCode(b). Значение, возвращаемое этим методом, равно значению, которое было бы получено путём вызова метода hashCode на List, содержащем последовательность Long экземпляров, представляющих элементы a в том же порядке. Если a равен null, этот метод возвращает 0.
- Parameters:
-
a- массив, хэш-значение которого нужно вычислить - Returns:
- хэш-код, основанный на содержимом
a - Since:
- 1.5
hashCode
public static int hashCode(int[] a)
int массивов a и b, таких, что Arrays.equals(a, b), также верно, что Arrays.hashCode(a) == Arrays.hashCode(b). Значение, возвращаемое этим методом, равно значению, которое было бы получено путём вызова метода hashCode на List, содержащем последовательность Integer экземпляров, представляющих элементы a в том же порядке. Если a равен null, этот метод возвращает 0.
- Parameters:
-
a- массив, хэш-значение которого нужно вычислить - Returns:
- хэш-код, основанный на содержимом
a - Since:
- 1.5
hashCode
public static int hashCode(short[] a)
short массивов a и b, таких, что Arrays.equals(a, b), также верно, что Arrays.hashCode(a) == Arrays.hashCode(b). Значение, возвращаемое этим методом, равно значению, которое было бы получено путём вызова метода hashCode на List, содержащем последовательность Short экземпляров, представляющих элементы a в том же порядке. Если a равен null, этот метод возвращает 0.
- Parameters:
-
a- массив, хэш-значение которого нужно вычислить - Returns:
- хэш-код, основанный на содержимом
a - Since:
- 1.5
hashCode
public static int hashCode(char[] a)
char массивов a и b, таких что Arrays.equals(a, b), также верно, что Arrays.hashCode(a) == Arrays.hashCode(b). Значение, возвращаемое этим методом, совпадает со значением, которое было бы получено при вызове метода hashCode для List, содержащего последовательность объектов Character, представляющих элементы a в том же порядке. Если a является null, этот метод возвращает 0.
- Параметры:
-
a- массив, для которого необходимо вычислить хэш-код - Возвращает:
- хэш-код, основанный на содержимом
a - С:
- 1.5
hashCode
public static int hashCode(byte[] a)
byte массивов a и b, таких что Arrays.equals(a, b), также верно, что Arrays.hashCode(a) == Arrays.hashCode(b). Значение, возвращаемое этим методом, совпадает со значением, которое было бы получено при вызове метода hashCode для List, содержащего последовательность объектов Byte, представляющих элементы a в том же порядке. Если a является null, этот метод возвращает 0.
- Параметры:
-
a- массив, для которого необходимо вычислить хэш-код - Возвращает:
- хэш-код, основанный на содержимом
a - С:
- 1.5
hashCode
public static int hashCode(boolean[] a)
boolean массивов a и b, таких что Arrays.equals(a, b), также верно, что Arrays.hashCode(a) == Arrays.hashCode(b). Значение, возвращаемое этим методом, совпадает со значением, которое было бы получено при вызове метода hashCode для List, содержащего последовательность объектов Boolean, представляющих элементы a в том же порядке. Если a является null, этот метод возвращает 0.
- Параметры:
-
a- массив, для которого необходимо вычислить хэш-код - Возвращает:
- хэш-код, основанный на содержимом
a - С:
- 1.5
hashCode
public static int hashCode(float[] a)
float массивов a и b, таких что Arrays.equals(a, b), также верно, что Arrays.hashCode(a) == Arrays.hashCode(b). Значение, возвращаемое этим методом, совпадает со значением, которое было бы получено при вызове метода hashCode для List, содержащего последовательность объектов Float, представляющих элементы a в том же порядке. Если a является null, этот метод возвращает 0.
- Параметры:
-
a- массив, для которого необходимо вычислить хэш-код - Возвращает:
- хэш-код, основанный на содержимом
a - С:
- 1.5
hashCode
public static int hashCode(double[] a)
double массивов a и b, таких что Arrays.equals(a, b), также верно, что Arrays.hashCode(a) == Arrays.hashCode(b). Значение, возвращаемое этим методом, совпадает со значением, которое было бы получено при вызове метода hashCode для List, содержащего последовательность объектов Double, представляющих элементы a в том же порядке. Если a является null, этот метод возвращает 0.
- Параметры:
-
a- массив, для которого необходимо вычислить хэш-код - Возвращает:
- хэш-код, основанный на содержимом
a - С:
- 1.5
hashCode
public static int hashCode(Object[] a)
Для любых двух массивов a и b, таких что Arrays.equals(a, b), также верно, что Arrays.hashCode(a) == Arrays.hashCode(b).
Значение, возвращаемое этим методом, равно значению, которое было бы возвращено Arrays.asList(a).hashCode(), за исключением случаев, когда a является null, в этом случае возвращается 0.
- Параметры:
-
a- массив, для которого нужно вычислить хэш-код, основанный на содержимом - Возвращает:
- хэш-код, основанный на содержимом
a - С:
- 1.5
- См. также:
deepHashCode
public static int deepHashCode(Object[] a)
Для любых двух массивов a и b, таких что Arrays.deepEquals(a, b), также верно, что Arrays.deepHashCode(a) == Arrays.deepHashCode(b).
Вычисление значения, возвращаемого этим методом, аналогично вычислению значения, возвращаемого методом List.hashCode() для списка, содержащего те же элементы, что и a, в том же порядке, с одним отличием: если элемент e из a сам является массивом, его хэш-код вычисляется не путём вызова e.hashCode(), а путём вызова соответствующего перегрузки Arrays.hashCode(e), если e представляет массив примитивного типа, или путем рекурсивного вызова Arrays.deepHashCode(e), если e представляет массив ссылочного типа. Если a является null, этот метод возвращает 0.
- Параметры:
-
a- массив, для которого нужно вычислить хэш-код, основанный на глубоком содержимом - Возвращает:
- хэш-код, основанный на глубоком содержимом
a - С:
- 1.5
- См. также:
deepEquals
public static boolean deepEquals(Object[] a1, Object[] a2)
true, если два указанных массива глубоко равны друг другу. В отличие от метода equals(Object[],Object[]), этот метод подходит для использования с вложенными массивами произвольной глубины. Две ссылки на массивы считаются глубоко равными, если обе являются null, или если они ссылаются на массивы, содержащие одинаковое количество элементов, и все соответствующие пары элементов в двух массивах глубоко равны.
Два, возможно, null элемента e1 и e2 глубоко равны, если выполняются какие-либо из следующих условий:
-
e1иe2являются массивами ссылочных типов, иArrays.deepEquals(e1, e2) would return true -
e1иe2являются массивами одного и того же примитивного типа, и соответствующая перегрузкаArrays.equals(e1, e2)вернула бы true. -
e1 == e2 -
e1.equals(e2)вернула бы true.
null на любой глубине. Если любой из указанных массивов содержит сам себя в качестве элемента, прямо или косвенно через один или несколько уровней вложенности массивов, поведение этого метода не определено.
- Параметры:
-
a1- один из массивов, который необходимо проверить на равенство -
a2- другой массив, который необходимо проверить на равенство - Возвращает:
-
true, если два массива равны - С:
- 1.5
- См. также:
toString
public static String toString(long[] a)
"[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки с помощью String.valueOf(long). Возвращает "null", если a равен null.- Parameters:
-
a- массив, строковое представление которого требуется вернуть - Returns:
- строковое представление
a - Since:
- 1.5
toString
public static String toString(int[] a)
"[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки с помощью String.valueOf(int). Возвращает "null", если a равен null.- Parameters:
-
a- массив, строковое представление которого требуется вернуть - Returns:
- строковое представление
a - Since:
- 1.5
toString
public static String toString(short[] a)
"[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки с помощью String.valueOf(short). Возвращает "null", если a равен null.- Parameters:
-
a- массив, строковое представление которого требуется вернуть - Returns:
- строковое представление
a - Since:
- 1.5
toString
public static String toString(char[] a)
"[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки с помощью String.valueOf(char). Возвращает "null", если a равен null.- Parameters:
-
a- массив, строковое представление которого требуется вернуть - Returns:
- строковое представление
a - Since:
- 1.5
toString
public static String toString(byte[] a)
"[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки с помощью String.valueOf(byte). Возвращает "null", если a равен null.- Parameters:
-
a- массив, строковое представление которого требуется вернуть - Returns:
- строковое представление
a - Since:
- 1.5
toString
public static String toString(boolean[] a)
"[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки с помощью String.valueOf(boolean). Возвращает "null", если a равен null.- Parameters:
-
a- массив, строковое представление которого требуется вернуть - Returns:
- строковое представление
a - Since:
- 1.5
toString
public static String toString(float[] a)
"[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки с помощью String.valueOf(float). Возвращает "null", если a равен null.- Parameters:
-
a- массив, строковое представление которого требуется вернуть - Returns:
- строковое представление
a - Since:
- 1.5
toString
public static String toString(double[] a)
"[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки с помощью String.valueOf(double). Возвращает "null", если a равен null.- Parameters:
-
a- массив, строковое представление которого требуется вернуть - Returns:
- строковое представление
a - Since:
- 1.5
toString
public static String toString(Object[] a)
Object.toString(), унаследованного от Object, который описывает их идентичность, а не содержимое. Значение, возвращаемое этим методом, равно значению, которое было бы возвращено Arrays.asList(a).toString(), за исключением случая, когда a равен null, в этом случае возвращается "null".
- Parameters:
-
a- массив, строковое представление которого требуется вернуть - Returns:
- строковое представление
a - Since:
- 1.5
- See Also:
deepToString
public static String deepToString(Object[] a)
Строковое представление состоит из списка элементов массива, заключённых в квадратные скобки ("[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки с помощью String.valueOf(Object), если это не массивы.
Если элемент e является массивом примитивного типа, он преобразуется в строку путём вызова соответствующего перегрузки Arrays.toString(e). Если элемент e является массивом ссылочного типа, он преобразуется в строку с помощью рекурсивного вызова этого метода.
Чтобы избежать бесконечной рекурсии, если указанный массив содержит себя в качестве элемента или содержит косвенную ссылку на себя через один или несколько уровней массивов, самоссылка преобразуется в строку "[...]". Например, массив, содержащий только ссылку на себя, будет представлен как "[[...]]".
Этот метод возвращает "null", если указанный массив является null.
- Parameters:
-
a- массив, строковое представление которого требуется вернуть - Returns:
- строковое представление
a - Since:
- 1.5
- See Also:
setAll
public static <T> void setAll(T[] array, IntFunction<? extends T> generator)
Если функция-генератор вызывает исключение, оно передаётся вызывающей стороне, а массив остаётся в неопределённом состоянии.
- API Note:
- Установка поддиапазона массива с использованием функции-генератора для вычисления каждого элемента может быть записана следующим образом:
IntStream.range(startInclusive, endExclusive) .forEach(i -> array[i] = generator.apply(i)); - Type Parameters:
-
T- тип элементов массива - Parameters:
-
array- массив, подлежащий инициализации -
generator- функция, принимающая индекс и генерирующая нужное значение для этой позиции - Throws:
-
NullPointerException- если генератор равен null - Since:
- 1.8
parallelSetAll
public static <T> void parallelSetAll(T[] array, IntFunction<? extends T> generator)
Если функция-генератор вызывает исключение, необрабатываемое исключение выбрасывается из parallelSetAll, и массив остаётся в неопределённом состоянии.
- API Note:
- Установку поддиапазона массива в параллельном режиме с использованием функции-генератора для вычисления каждого элемента можно записать следующим образом:
IntStream.range(startInclusive, endExclusive) .parallel() .forEach(i -> array[i] = generator.apply(i)); - Type Parameters:
-
T- тип элементов массива - Parameters:
-
array- массив, который должен быть инициализирован -
generator- функция, принимающая индекс и генерирующая требуемое значение для этой позиции - Throws:
-
NullPointerException- если генератор равен null - Since:
- 1.8
setAll
public static void setAll(int[] array, IntUnaryOperator generator)
Если функция-генератор вызывает исключение, оно передаётся вызывающему методу, а массив остаётся в неопределённом состоянии.
- API Note:
- Установку поддиапазона массива с использованием функции-генератора для вычисления каждого элемента можно записать следующим образом:
IntStream.range(startInclusive, endExclusive) .forEach(i -> array[i] = generator.applyAsInt(i)); - Parameters:
-
array- массив, который должен быть инициализирован -
generator- функция, принимающая индекс и генерирующая требуемое значение для этой позиции - Throws:
-
NullPointerException- если генератор равен null - Since:
- 1.8
parallelSetAll
public static void parallelSetAll(int[] array, IntUnaryOperator generator)
Если функция-генератор вызывает исключение, необрабатываемое исключение выбрасывается из parallelSetAll, и массив остаётся в неопределённом состоянии.
- API Note:
- Установку поддиапазона массива в параллельном режиме с использованием функции-генератора для вычисления каждого элемента можно записать следующим образом:
IntStream.range(startInclusive, endExclusive) .parallel() .forEach(i -> array[i] = generator.applyAsInt(i)); - Parameters:
-
array- массив, который должен быть инициализирован -
generator- функция, принимающая индекс и генерирующая требуемое значение для этой позиции - Throws:
-
NullPointerException- если генератор равен null - Since:
- 1.8
setAll
public static void setAll(long[] array, IntToLongFunction generator)
Если функция-генератор вызывает исключение, оно передаётся вызывающему методу, а массив остаётся в неопределённом состоянии.
- API Note:
- Установку поддиапазона массива с использованием функции-генератора для вычисления каждого элемента можно записать следующим образом:
IntStream.range(startInclusive, endExclusive) .forEach(i -> array[i] = generator.applyAsLong(i)); - Parameters:
-
array- массив, который должен быть инициализирован -
generator- функция, принимающая индекс и генерирующая требуемое значение для этой позиции - Throws:
-
NullPointerException- если генератор равен null - Since:
- 1.8
parallelSetAll
public static void parallelSetAll(long[] array, IntToLongFunction generator)
Если функция-генератор вызывает исключение, необрабатываемое исключение выбрасывается из parallelSetAll, и массив остаётся в неопределённом состоянии.
- API Note:
- Установку поддиапазона массива в параллельном режиме с использованием функции-генератора для вычисления каждого элемента можно записать следующим образом:
IntStream.range(startInclusive, endExclusive) .parallel() .forEach(i -> array[i] = generator.applyAsLong(i)); - Parameters:
-
array- массив, который должен быть инициализирован -
generator- функция, принимающая индекс и генерирующая требуемое значение для этой позиции - Throws:
-
NullPointerException- если генератор равен null - Since:
- 1.8
setAll
public static void setAll(double[] array, IntToDoubleFunction generator)
Если функция-генератор вызывает исключение, оно передаётся вызывающему методу, а массив остаётся в неопределённом состоянии.
- API Note:
- Установку поддиапазона массива с использованием функции-генератора для вычисления каждого элемента можно записать следующим образом:
IntStream.range(startInclusive, endExclusive) .forEach(i -> array[i] = generator.applyAsDouble(i)); - Parameters:
-
array- массив, который должен быть инициализирован -
generator- функция, принимающая индекс и генерирующая требуемое значение для этой позиции - Throws:
-
NullPointerException- если генератор равен null - Since:
- 1.8
parallelSetAll
public static void parallelSetAll(double[] array, IntToDoubleFunction generator)
Если функция-генератор вызывает исключение, необрабатываемое исключение выбрасывается из parallelSetAll, и массив остаётся в неопределённом состоянии.
- API Note:
- Установку поддиапазона массива в параллельном режиме с использованием функции-генератора для вычисления каждого элемента можно записать следующим образом:
IntStream.range(startInclusive, endExclusive) .parallel() .forEach(i -> array[i] = generator.applyAsDouble(i)); - Parameters:
-
array- массив, который должен быть инициализирован -
generator- функция, принимающая индекс и генерирующая требуемое значение для этой позиции - Throws:
-
NullPointerException- если генератор равен null - Since:
- 1.8
spliterator
public static <T> Spliterator<T> spliterator(T[] array)
Spliterator, охватывающий весь указанный массив. Spliterator сообщает о Spliterator.SIZED, Spliterator.SUBSIZED, Spliterator.ORDERED и Spliterator.IMMUTABLE.
- Type Parameters:
-
T- тип элементов - Parameters:
-
array- массив, предполагается, что он не изменяется во время использования - Returns:
- spliterator для элементов массива
- Since:
- 1.8
spliterator
public static <T> Spliterator<T> spliterator(T[] array, int startInclusive, int endExclusive)
Spliterator, охватывающий указанный диапазон в указанном массиве. Spliterator сообщает о Spliterator.SIZED, Spliterator.SUBSIZED, Spliterator.ORDERED и Spliterator.IMMUTABLE.
- Type Parameters:
-
T- тип элементов - Parameters:
-
array- массив, предполагается, что он не изменяется во время использования -
startInclusive- первый индекс для охвата, включительно -
endExclusive- индекс, следующий сразу после последнего индекса для охвата - Returns:
- spliterator для элементов массива
- Throws:
-
ArrayIndexOutOfBoundsException- еслиstartInclusiveотрицательный,endExclusiveменьшеstartInclusiveилиendExclusiveбольше размера массива - Since:
- 1.8
spliterator
public static Spliterator.OfInt spliterator(int[] array)
Spliterator.OfInt, охватывающий весь указанный массив. Spliterator сообщает о Spliterator.SIZED, Spliterator.SUBSIZED, Spliterator.ORDERED и Spliterator.IMMUTABLE.
- Parameters:
-
array- массив, предполагается, что он не изменяется во время использования - Returns:
- spliterator для элементов массива
- Since:
- 1.8
spliterator
public static Spliterator.OfInt spliterator(int[] array, int startInclusive, int endExclusive)
Spliterator.OfInt, охватывающий указанный диапазон в указанном массиве. Spliterator сообщает о Spliterator.SIZED, Spliterator.SUBSIZED, Spliterator.ORDERED и Spliterator.IMMUTABLE.
- Parameters:
-
array- массив, предполагается, что он не изменяется во время использования -
startInclusive- первый индекс для охвата, включительно -
endExclusive- индекс, следующий сразу после последнего индекса для охвата - Returns:
- spliterator для элементов массива
- Throws:
-
ArrayIndexOutOfBoundsException- еслиstartInclusiveотрицательный,endExclusiveменьшеstartInclusiveилиendExclusiveбольше размера массива - Since:
- 1.8
spliterator
public static Spliterator.OfLong spliterator(long[] array)
Spliterator.OfLong, охватывающий весь указанный массив. Spliterator сообщает о Spliterator.SIZED, Spliterator.SUBSIZED, Spliterator.ORDERED и Spliterator.IMMUTABLE.
- Parameters:
-
array- массив, предполагается, что он не изменяется во время использования - Returns:
- spliterator для элементов массива
- Since:
- 1.8
spliterator
public static Spliterator.OfLong spliterator(long[] array, int startInclusive, int endExclusive)
Spliterator.OfLong, охватывающую указанный диапазон указанного массива. Разделитель сообщает о Spliterator.SIZED, Spliterator.SUBSIZED, Spliterator.ORDERED и Spliterator.IMMUTABLE.
- Parameters:
-
array- массив, предполагается неизменным во время использования -
startInclusive- первый индекс для охвата, включительно -
endExclusive- индекс, непосредственно следующий за последним индексом для охвата - Returns:
- разделитель для элементов массива
- Throws:
-
ArrayIndexOutOfBoundsException- еслиstartInclusiveотрицателен,endExclusiveменьшеstartInclusiveилиendExclusiveбольше размера массива - Since:
- 1.8
spliterator
public static Spliterator.OfDouble spliterator(double[] array)
Spliterator.OfDouble, охватывающую весь указанный массив. Разделитель сообщает о Spliterator.SIZED, Spliterator.SUBSIZED, Spliterator.ORDERED и Spliterator.IMMUTABLE.
- Parameters:
-
array- массив, предполагается неизменным во время использования - Returns:
- разделитель для элементов массива
- Since:
- 1.8
spliterator
public static Spliterator.OfDouble spliterator(double[] array, int startInclusive, int endExclusive)
Spliterator.OfDouble, охватывающую указанный диапазон указанного массива. Разделитель сообщает о Spliterator.SIZED, Spliterator.SUBSIZED, Spliterator.ORDERED и Spliterator.IMMUTABLE.
- Parameters:
-
array- массив, предполагается неизменным во время использования -
startInclusive- первый индекс для охвата, включительно -
endExclusive- индекс, непосредственно следующий за последним индексом для охвата - Returns:
- разделитель для элементов массива
- Throws:
-
ArrayIndexOutOfBoundsException- еслиstartInclusiveотрицателен,endExclusiveменьшеstartInclusiveилиendExclusiveбольше размера массива - Since:
- 1.8
stream
public static <T> Stream<T> stream(T[] array)
Stream с указанным массивом в качестве источника.- Type Parameters:
-
T- тип элементов массива - Parameters:
-
array- массив, предполагается неизменным во время использования - Returns:
Streamдля массива- Since:
- 1.8
stream
public static <T> Stream<T> stream(T[] array, int startInclusive, int endExclusive)
Stream с указанным диапазоном указанного массива в качестве источника.- Type Parameters:
-
T- тип элементов массива - Parameters:
-
array- массив, предполагается неизменным во время использования -
startInclusive- первый индекс для охвата, включительно -
endExclusive- индекс, непосредственно следующий за последним индексом для охвата - Returns:
Streamдля диапазона массива- Throws:
-
ArrayIndexOutOfBoundsException- еслиstartInclusiveотрицателен,endExclusiveменьшеstartInclusiveилиendExclusiveбольше размера массива - Since:
- 1.8
stream
public static IntStream stream(int[] array)
IntStream с указанным массивом в качестве источника.- Parameters:
-
array- массив, предполагается неизменным во время использования - Returns:
IntStreamдля массива- Since:
- 1.8
stream
public static IntStream stream(int[] array, int startInclusive, int endExclusive)
IntStream с указанным диапазоном указанного массива в качестве источника.- Parameters:
-
array- массив, предполагается неизменным во время использования -
startInclusive- первый индекс для охвата, включительно -
endExclusive- индекс, непосредственно следующий за последним индексом для охвата - Returns:
IntStreamдля диапазона массива- Throws:
-
ArrayIndexOutOfBoundsException- еслиstartInclusiveотрицателен,endExclusiveменьшеstartInclusiveилиendExclusiveбольше размера массива - Since:
- 1.8
stream
public static LongStream stream(long[] array)
LongStream с указанным массивом в качестве источника.- Parameters:
-
array- массив, предполагается неизменным во время использования - Returns:
LongStreamдля массива- Since:
- 1.8
stream
public static LongStream stream(long[] array, int startInclusive, int endExclusive)
LongStream с указанным диапазоном указанного массива в качестве источника.- Parameters:
-
array- массив, предполагается неизменным во время использования -
startInclusive- первый индекс для охвата, включительно -
endExclusive- индекс, непосредственно следующий за последним индексом для охвата - Returns:
LongStreamдля диапазона массива- Throws:
-
ArrayIndexOutOfBoundsException- еслиstartInclusiveотрицателен,endExclusiveменьшеstartInclusiveилиendExclusiveбольше размера массива - Since:
- 1.8
stream
public static DoubleStream stream(double[] array)
DoubleStream с указанным массивом в качестве источника.- Parameters:
-
array- массив, предполагается неизменным во время использования - Returns:
DoubleStreamдля массива- Since:
- 1.8
stream
public static DoubleStream stream(double[] array, int startInclusive, int endExclusive)
DoubleStream с указанным диапазоном указанного массива в качестве источника.- Parameters:
-
array- массив, предполагается неизменным во время использования -
startInclusive- первый индекс для охвата, включительно -
endExclusive- индекс, непосредственно следующий за последним индексом для охвата - Returns:
DoubleStreamдля диапазона массива- Throws:
-
ArrayIndexOutOfBoundsException- еслиstartInclusiveотрицателен,endExclusiveменьшеstartInclusiveилиendExclusiveбольше размера массива - Since:
- 1.8
compare
public static int compare(boolean[] a, boolean[] b)
boolean лексикографически. Если два массива имеют общий префикс, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы они были сравнены с помощью Boolean.compare(boolean, boolean) в индексе в соответствующих массивах, который является длиной префикса. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух массивов. (См. mismatch(boolean[], boolean[]) для определения общего и правильного префикса.)
Ссылка на массив null считается лексикографически меньше, чем ссылка на не-null массив. Две ссылки на массивы null считаются равными.
Сравнение согласуется с equals, более конкретно для массивов a и b:
Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
- API Note:
-
Этот метод ведет себя так, как если бы (для ссылок на массивы, не являющиеся
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Boolean.compare(a[i], b[i]); return a.length - b.length; - Parameters:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Returns:
- значение
0, если первый и второй массивы равны и содержат те же элементы в том же порядке; значение меньше0, если первый массив лексикографически меньше второго; и значение больше0, если первый массив лексикографически больше второго - Since:
- 9
compare
public static int compare(boolean[] a, int aFromIndex, int aToIndex, boolean[] b, int bFromIndex, int bToIndex)
boolean лексикографически в указанных диапазонах. Если два массива в указанных диапазонах имеют общую префиксную часть, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы это было выполнено с помощью Boolean.compare(boolean, boolean), в относительном индексе в соответствующих массивах, который равен длине префикса. В противном случае один массив является собственным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух диапазонов. (См. mismatch(boolean[], int, int, boolean[], int, int) для определения общей и собственной префиксной части.)
Сравнение согласуется с equals, более конкретно, следующее справедливо для массивов a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно:
Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
(Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)
- API Note:
-
Этот метод ведет себя так, как если бы:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Boolean.compare(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Параметры:
-
a— первый массив для сравнения -
aFromIndex— индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex— индекс (исключительно) последнего элемента в первом массиве для сравнения -
b— второй массив для сравнения -
bFromIndex— индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex— индекс (исключительно) последнего элемента во втором массиве для сравнения - Возвращает:
- значение
0, если в указанных диапазонах первый и второй массив равны и содержат те же элементы в том же порядке; значение меньше0, если в указанных диапазонах первый массив лексикографически меньше второго массива; и значение больше0, если в указанных диапазонах первый массив лексикографически больше второго массива - Издаёт:
-
IllegalArgumentException— еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException— еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException— если любой из массивов являетсяnull - С:
- 9
compare
public static int compare(byte[] a, byte[] b)
byte лексикографически. Если два массива имеют общую префиксную часть, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы это было выполнено с помощью Byte.compare(byte, byte), в индексе в соответствующих массивах, равном длине префикса. В противном случае один массив является собственным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух массивов. (См. mismatch(byte[], byte[]) для определения общей и собственной префиксной части.)
Ссылка на массив null считается лексикографически меньше ссылки на массив без null. Две ссылки на массив null считаются равными.
Сравнение согласуется с equals, более конкретно, следующее справедливо для массивов a и b:
Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
- API Note:
-
Этот метод ведет себя так, как если бы (для ссылок на массивы, не являющиеся
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Byte.compare(a[i], b[i]); return a.length - b.length; - Параметры:
-
a— первый массив для сравнения -
b— второй массив для сравнения - Возвращает:
- значение
0, если первый и второй массив равны и содержат те же элементы в том же порядке; значение меньше0, если первый массив лексикографически меньше второго массива; и значение больше0, если первый массив лексикографически больше второго массива - С:
- 9
compare
public static int compare(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex)
byte лексикографически в указанных диапазонах. Если два массива в указанных диапазонах имеют общую префиксную часть, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы это было выполнено с помощью Byte.compare(byte, byte), в относительном индексе в соответствующих массивах, который равен длине префикса. В противном случае один массив является собственным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух диапазонов. (См. mismatch(byte[], int, int, byte[], int, int) для определения общей и собственной префиксной части.)
Сравнение согласуется с equals, более конкретно, следующее справедливо для массивов a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно:
Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
(Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)
- API Note:
-
Этот метод ведет себя так, как если бы:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Byte.compare(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Параметры:
-
a— первый массив для сравнения -
aFromIndex— индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex— индекс (исключительно) последнего элемента в первом массиве для сравнения -
b— второй массив для сравнения -
bFromIndex— индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex— индекс (исключительно) последнего элемента во втором массиве для сравнения - Возвращает:
- значение
0, если в указанных диапазонах первый и второй массив равны и содержат те же элементы в том же порядке; значение меньше0, если в указанных диапазонах первый массив лексикографически меньше второго массива; и значение больше0, если в указанных диапазонах первый массив лексикографически больше второго массива - Издаёт:
-
IllegalArgumentException— еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException— еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException— если любой из массивов являетсяnull - С:
- 9
compareUnsigned
public static int compareUnsigned(byte[] a, byte[] b)
byte, числовое, рассматривая элементы как беззнаковые. Если два массива имеют общую префиксную часть, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы это было выполнено с помощью Byte.compareUnsigned(byte, byte), в индексе в соответствующих массивах, равном длине префикса. В противном случае один массив является собственным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух массивов. (См. mismatch(byte[], byte[]) для определения общей и собственной префиксной части.)
Ссылка на массив null считается лексикографически меньше ссылки на массив без null. Две ссылки на массив null считаются равными.
- API Note:
-
Этот метод ведет себя так, как если бы (для ссылок на массивы, не являющиеся
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Byte.compareUnsigned(a[i], b[i]); return a.length - b.length; - Параметры:
-
a— первый массив для сравнения -
b— второй массив для сравнения - Возвращает:
- значение
0, если первый и второй массив равны и содержат те же элементы в том же порядке; значение меньше0, если первый массив лексикографически меньше второго массива; и значение больше0, если первый массив лексикографически больше второго массива - С:
- 9
compareUnsigned
public static int compareUnsigned(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex)
byte в указанных диапазонах, числовое, рассматривая элементы как беззнаковые. Если два массива в указанных диапазонах имеют общую префиксную часть, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы это было выполнено с помощью Byte.compareUnsigned(byte, byte), в относительном индексе в соответствующих массивах, который равен длине префикса. В противном случае один массив является собственным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух диапазонов. (См. mismatch(byte[], int, int, byte[], int, int) для определения общей и собственной префиксной части.)
- API Note:
-
Этот метод ведет себя так, как если бы:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Byte.compareUnsigned(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Параметры:
-
a— первый массив для сравнения -
aFromIndex— индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex— индекс (исключительно) последнего элемента в первом массиве для сравнения -
b— второй массив для сравнения -
bFromIndex— индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex— индекс (исключительно) последнего элемента во втором массиве для сравнения - Возвращает:
- значение
0, если в указанных диапазонах первый и второй массив равны и содержат те же элементы в том же порядке; значение меньше0, если в указанных диапазонах первый массив лексикографически меньше второго массива; и значение больше0, если в указанных диапазонах первый массив лексикографически больше второго массива - Издаёт:
-
IllegalArgumentException— еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException— еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException— если любой из массивов равен null - С:
- 9
compare
public static int compare(short[] a, short[] b)
short лексикографически. Если два массива имеют общую префиксную часть, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы это делалось с помощью Short.compare(short, short), в индексе, соответствующем длине префикса в каждом из массивов. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух массивов. (См. mismatch(short[], short[]) для определения общего и правильного префикса.)
Ссылка на массив null считается лексикографически меньше, чем ссылка на массив, который не является null. Две ссылки на массив null считаются равными.
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b:
Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
- API Note:
-
Этот метод ведет себя так, как если бы (для ссылок на массивы, которые не являются
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Short.compare(a[i], b[i]); return a.length - b.length; - Parameters:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Returns:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше, чем0, если первый массив лексикографически меньше второго массива; и значение больше, чем0, если первый массив лексикографически больше второго массива - Since:
- 9
compare
public static int compare(short[] a, int aFromIndex, int aToIndex, short[] b, int bFromIndex, int bToIndex)
short лексикографически в заданных диапазонах. Если два массива в указанных диапазонах имеют общую префиксную часть, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы это делалось с помощью Short.compare(short, short), в относительном индексе в соответствующих массивах, который является длиной префикса. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух диапазонов. (См. mismatch(short[], int, int, short[], int, int) для определения общего и правильного префикса.)
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно:
Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
(Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)
- API Note:
-
Этот метод ведет себя так:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Short.compare(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Parameters:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения - Returns:
- значение
0, если, в указанных диапазонах, первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше, чем0, если в указанных диапазонах первый массив лексикографически меньше второго массива; и значение больше, чем0, если в указанных диапазонах первый массив лексикографически больше второго массива - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - Since:
- 9
compareUnsigned
public static int compareUnsigned(short[] a, short[] b)
short лексикографически, рассматривая элементы как беззнаковые. Если два массива имеют общую префиксную часть, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы это делалось с помощью Short.compareUnsigned(short, short), в индексе, соответствующем длине префикса в каждом из массивов. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух массивов. (См. mismatch(short[], short[]) для определения общего и правильного префикса.)
Ссылка на массив null считается лексикографически меньше, чем ссылка на массив, который не является null. Две ссылки на массив null считаются равными.
- API Note:
-
Этот метод ведет себя так, как если бы (для ссылок на массивы, которые не являются
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Short.compareUnsigned(a[i], b[i]); return a.length - b.length; - Parameters:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Returns:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше, чем0, если первый массив лексикографически меньше второго массива; и значение больше, чем0, если первый массив лексикографически больше второго массива - Since:
- 9
compareUnsigned
public static int compareUnsigned(short[] a, int aFromIndex, int aToIndex, short[] b, int bFromIndex, int bToIndex)
short лексикографически в заданных диапазонах, рассматривая элементы как беззнаковые. Если два массива в указанных диапазонах имеют общую префиксную часть, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы это делалось с помощью Short.compareUnsigned(short, short), в относительном индексе в соответствующих массивах, который является длиной префикса. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух диапазонов. (См. mismatch(short[], int, int, short[], int, int) для определения общего и правильного префикса.)
- API Note:
-
Этот метод ведет себя так:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Short.compareUnsigned(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Parameters:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения - Returns:
- значение
0, если, в указанных диапазонах, первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше, чем0, если в указанных диапазонах первый массив лексикографически меньше второго массива; и значение больше, чем0, если в указанных диапазонах первый массив лексикографически больше второго массива - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов равен null - Since:
- 9
compare
public static int compare(char[] a, char[] b)
char лексикографически. Если два массива имеют общую префиксную часть, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы это делалось с помощью Character.compare(char, char), в индексе, соответствующем длине префикса в каждом из массивов. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух массивов. (См. mismatch(char[], char[]) для определения общего и правильного префикса.)
Ссылка на массив null считается лексикографически меньше, чем ссылка на массив, который не является null. Две ссылки на массив null считаются равными.
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b:
Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
- API Note:
-
Этот метод ведет себя так, как если бы (для ссылок на массивы, которые не являются
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Character.compare(a[i], b[i]); return a.length - b.length; - Parameters:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Returns:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше, чем0, если первый массив лексикографически меньше второго массива; и значение больше, чем0, если первый массив лексикографически больше второго массива - Since:
- 9
compare
public static int compare(char[] a, int aFromIndex, int aToIndex, char[] b, int bFromIndex, int bToIndex)
char лексикографически в заданных диапазонах. Если два массива в заданных диапазонах имеют общую префиксную часть, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы это было выполнено с помощью Character.compare(char, char) в относительном индексе внутри соответствующих массивов, который равен длине префикса. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух диапазонов. (См. mismatch(char[], int, int, char[], int, int) для определения общего и правильного префикса.)
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно:
Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
(Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)
- API Note:
-
Этот метод ведет себя так, как будто:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Character.compare(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Параметры:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения - Возвращает:
- значение
0, если в заданных диапазонах первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если в заданных диапазонах первый массив лексикографически меньше второго; и значение больше0, если в заданных диапазонах первый массив лексикографически больше второго - Исключения:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов равенnull - С тех пор:
- 9
compare
public static int compare(int[] a, int[] b)
int лексикографически. Если два массива имеют общую префиксную часть, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы это было выполнено с помощью Integer.compare(int, int) в индексе внутри соответствующих массивов, который равен длине префикса. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух массивов. (См. mismatch(int[], int[]) для определения общего и правильного префикса.)
Ссылка на массив null считается лексикографически меньше ссылки на массив, не являющийся null. Две ссылки на массив null считаются равными.
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b:
Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
- API Note:
-
Этот метод ведет себя так, как будто (для ссылок на массивы, не являющиеся
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Integer.compare(a[i], b[i]); return a.length - b.length; - Параметры:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Возвращает:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если первый массив лексикографически меньше второго; и значение больше0, если первый массив лексикографически больше второго - С тех пор:
- 9
compare
public static int compare(int[] a, int aFromIndex, int aToIndex, int[] b, int bFromIndex, int bToIndex)
int лексикографически в заданных диапазонах. Если два массива в заданных диапазонах имеют общую префиксную часть, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы это было выполнено с помощью Integer.compare(int, int) в относительном индексе внутри соответствующих массивов, который равен длине префикса. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух диапазонов. (См. mismatch(int[], int, int, int[], int, int) для определения общего и правильного префикса.)
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно:
Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
(Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)
- API Note:
-
Этот метод ведет себя так, как будто:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Integer.compare(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Параметры:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения - Возвращает:
- значение
0, если в заданных диапазонах первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если в заданных диапазонах первый массив лексикографически меньше второго; и значение больше0, если в заданных диапазонах первый массив лексикографически больше второго - Исключения:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиArrayIndexOutOfBoundsExceptionили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов равен null - С тех пор:
- 9
compareUnsigned
public static int compareUnsigned(int[] a, int[] b)
int лексикографически, численно обрабатывая элементы как беззнаковые. Если два массива имеют общую префиксную часть, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы это было выполнено с помощью Integer.compareUnsigned(int, int) в индексе внутри соответствующих массивов, который равен длине префикса. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух массивов. (См. mismatch(int[], int[]) для определения общего и правильного префикса.)
Ссылка на массив null считается лексикографически меньше ссылки на массив, не являющийся null. Две ссылки на массив null считаются равными.
- API Note:
-
Этот метод ведет себя так, как будто (для ссылок на массивы, не являющиеся
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Integer.compareUnsigned(a[i], b[i]); return a.length - b.length; - Параметры:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Возвращает:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если первый массив лексикографически меньше второго; и значение больше0, если первый массив лексикографически больше второго - С тех пор:
- 9
compareUnsigned
public static int compareUnsigned(int[] a, int aFromIndex, int aToIndex, int[] b, int bFromIndex, int bToIndex)
int лексикографически в заданных диапазонах, численно обрабатывая элементы как беззнаковые. Если два массива в заданных диапазонах имеют общую префиксную часть, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы это было выполнено с помощью Integer.compareUnsigned(int, int) в относительном индексе внутри соответствующих массивов, который равен длине префикса. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух диапазонов. (См. mismatch(int[], int, int, int[], int, int) для определения общего и правильного префикса.)
- API Note:
-
Этот метод ведет себя так:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Integer.compareUnsigned(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Параметры:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения - Возвращает:
- значение
0, если в заданных диапазонах первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если в заданных диапазонах первый массив лексикографически меньше второго; и значение больше0, если в заданных диапазонах первый массив лексикографически больше второго - Исключения:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов равен null - С тех пор:
- 9
compare
public static int compare(long[] a, long[] b)
long лексикографически. Если два массива имеют общую префиксную часть, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы они были сравнены с помощью Long.compare(long, long) по индексу, соответствующему длине префикса в каждом из массивов. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух массивов. (См. mismatch(long[], long[]) для определения общего и правильного префикса.)
Ссылка на массив null считается лексикографически меньше, чем ссылка на массив, который не null. Две ссылки на массив null считаются равными.
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b:
Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
- API Note:
-
Этот метод ведет себя так, как будто (для ссылок на массивы, которые не
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Long.compare(a[i], b[i]); return a.length - b.length; - Parameters:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Returns:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если первый массив лексикографически меньше второго массива; и значение больше0, если первый массив лексикографически больше второго массива - Since:
- 9
compare
public static int compare(long[] a, int aFromIndex, int aToIndex, long[] b, int bFromIndex, int bToIndex)
long лексикографически в указанных диапазонах. Если два массива в указанных диапазонах имеют общую префиксную часть, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы они были сравнены с помощью Long.compare(long, long) по относительному индексу в соответствующих массивах, равном длине префикса. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух диапазонов. (См. mismatch(long[], int, int, long[], int, int) для определения общего и правильного префикса.)
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно:
Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
(Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)
- API Note:
-
Этот метод ведет себя так, как будто:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Long.compare(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Parameters:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения - Returns:
- значение
0, если в указанных диапазонах первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если в указанных диапазонах первый массив лексикографически меньше второго массива; и значение больше0, если в указанных диапазонах первый массив лексикографически больше второго массива - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов равен null - Since:
- 9
compareUnsigned
public static int compareUnsigned(long[] a, long[] b)
long лексикографически, численно рассматривая элементы как беззнаковые. Если два массива имеют общую префиксную часть, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы они были сравнены с помощью Long.compareUnsigned(long, long) по индексу, соответствующему длине префикса в каждом из массивов. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух массивов. (См. mismatch(long[], long[]) для определения общего и правильного префикса.)
Ссылка на массив null считается лексикографически меньше, чем ссылка на массив, который не null. Две ссылки на массив null считаются равными.
- API Note:
-
Этот метод ведет себя так, как будто (для ссылок на массивы, которые не
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Long.compareUnsigned(a[i], b[i]); return a.length - b.length; - Parameters:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Returns:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если первый массив лексикографически меньше второго массива; и значение больше0, если первый массив лексикографически больше второго массива - Since:
- 9
compareUnsigned
public static int compareUnsigned(long[] a, int aFromIndex, int aToIndex, long[] b, int bFromIndex, int bToIndex)
long лексикографически в указанных диапазонах, численно рассматривая элементы как беззнаковые. Если два массива в указанных диапазонах имеют общую префиксную часть, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы они были сравнены с помощью Long.compareUnsigned(long, long) по относительному индексу в соответствующих массивах, равном длине префикса. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух диапазонов. (См. mismatch(long[], int, int, long[], int, int) для определения общего и правильного префикса.)
- API Note:
-
Этот метод ведет себя так, как будто:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Long.compareUnsigned(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Parameters:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения - Returns:
- значение
0, если в указанных диапазонах первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если в указанных диапазонах первый массив лексикографически меньше второго массива; и значение больше0, если в указанных диапазонах первый массив лексикографически больше второго массива - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов равен null - Since:
- 9
compare
public static int compare(float[] a, float[] b)
float лексикографически. Если два массива имеют общую префиксную часть, то лексикографическое сравнение является результатом сравнения двух элементов, как если бы они были сравнены с помощью Float.compare(float, float) по индексу, соответствующему длине префикса в каждом из массивов. В противном случае один массив является правильным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух массивов. (См. mismatch(float[], float[]) для определения общего и правильного префикса.)
Ссылка на массив null считается лексикографически меньше, чем ссылка на массив, который не null. Две ссылки на массив null считаются равными.
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b:
Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
- API Note:
-
Этот метод ведет себя так, как будто (для ссылок на массивы, которые не
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Float.compare(a[i], b[i]); return a.length - b.length; - Parameters:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Returns:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если первый массив лексикографически меньше второго массива; и значение больше0, если первый массив лексикографически больше второго массива - Since:
- 9
compare
public static int compare(float[] a, int aFromIndex, int aToIndex, float[] b, int bFromIndex, int bToIndex)
float лексикографически в заданных диапазонах. Если два массива в заданных диапазонах имеют общий префикс, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы с помощью Float.compare(float, float) в относительном индексе в соответствующих массивах, который равен длине префикса. В противном случае один массив является собственным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух диапазонов. (См. mismatch(float[], int, int, float[], int, int) для определения общего и собственного префикса.)
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно:
Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
(Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)
- API Note:
-
Этот метод работает так, как если бы:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Float.compare(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Параметры:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения - Возвращает:
- значение
0, если в заданных диапазонах первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если в заданных диапазонах первый массив лексикографически меньше второго массива; и значение больше0, если в заданных диапазонах первый массив лексикографически больше второго массива - Выбрасывает:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - С тех пор:
- 9
compare
public static int compare(double[] a, double[] b)
double лексикографически. Если два массива имеют общий префикс, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы с помощью Double.compare(double, double) в индексе соответствующих массивов, равном длине префикса. В противном случае один массив является собственным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух массивов. (См. mismatch(double[], double[]) для определения общего и собственного префикса.)
Ссылка на массив null считается лексикографически меньше ссылки на массив, который не null. Две ссылки на массивы null считаются равными.
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b:
Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
- API Note:
-
Этот метод ведет себя так, как если бы (для ссылок на массивы, которые не
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return Double.compare(a[i], b[i]); return a.length - b.length; - Параметры:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Возвращает:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если первый массив лексикографически меньше второго массива; и значение больше0, если первый массив лексикографически больше второго массива - С тех пор:
- 9
compare
public static int compare(double[] a, int aFromIndex, int aToIndex, double[] b, int bFromIndex, int bToIndex)
double лексикографически в заданных диапазонах. Если два массива в заданных диапазонах имеют общий префикс, то лексикографическое сравнение — это результат сравнения двух элементов, как если бы с помощью Double.compare(double, double) в относительном индексе в соответствующих массивах, который равен длине префикса. В противном случае один массив является собственным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух диапазонов. (См. mismatch(double[], int, int, double[], int, int) для определения общего и собственного префикса.)
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно:
Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
(Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)
- API Note:
-
Этот метод ведет себя так, как если бы:
int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return Double.compare(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Параметры:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения - Возвращает:
- значение
0, если в заданных диапазонах первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если в заданных диапазонах первый массив лексикографически меньше второго массива; и значение больше0, если в заданных диапазонах первый массив лексикографически больше второго массива - Выбрасывает:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - С тех пор:
- 9
compare
public static <T extends Comparable<? super T>> int compare(T[] a, T[] b)
Object лексикографически, учитывая элементы, которые можно сравнивать. Если два массива имеют общий префикс, то лексикографическое сравнение — это результат сравнения двух элементов типа T в индексе i соответствующих массивов, который равен длине префикса, как если бы:
Comparator.nullsFirst(Comparator.<T>naturalOrder()).
compare(a[i], b[i])
В противном случае один массив является собственным префиксом другого, и лексикографическое сравнение — это результат сравнения длин двух массивов. (См. mismatch(Object[], Object[]) для определения общего и собственного префикса.) Ссылка на массив null считается лексикографически меньше ссылки на массив, который не null. Две ссылки на массивы null считаются равными. Элемент массива null считается лексикографически меньше, чем элемент массива, который не null. Два элемента массива null считаются равными.
Сравнение согласуется с equals, более конкретно, следующее выполняется для массивов a и b:
Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
- API Note:
-
Этот метод ведет себя так, как если бы (для ссылок на массивы и элементов, которые не
null):int i = Arrays.mismatch(a, b); if (i >= 0 && i < Math.min(a.length, b.length)) return a[i].compareTo(b[i]); return a.length - b.length; - Параметры типа:
-
T- тип сравниваемых элементов массива - Параметры:
-
a- первый массив для сравнения -
b- второй массив для сравнения - Возвращает:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше0, если первый массив лексикографически меньше второго массива; и значение больше0, если первый массив лексикографически больше второго массива - С тех пор:
- 9
сравнение
public static <T extends Comparable<? super T>> int compare(T[] a, int aFromIndex, int aToIndex, T[] b, int bFromIndex, int bToIndex)
Object массива лексикографически в заданных диапазонах. Если два массива в заданных диапазонах имеют общее префиксное совпадение, то лексикографическое сравнение является результатом сравнения двух элементов типа T с относительным индексом i в соответствующих массивах, равным длине префикса, как если бы:
Comparator.nullsFirst(Comparator.<T>naturalOrder()).
compare(a[aFromIndex + i, b[bFromIndex + i])
В противном случае один массив является надстрочным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух диапазонов. (См. mismatch(Object[], int, int, Object[], int, int) для определения общего и надстрочного префикса.) Сравнение согласуется с equals, точнее, для массивов a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно:
Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
(Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)
- Примечание API:
-
Этот метод ведет себя так, как будто (для элементов массива, не являющихся
null):int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return a[aFromIndex + i].compareTo(b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Параметры типа:
-
T- тип элементов массива сравнимых значений - Параметры:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения - Возвращает:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в одинаковом порядке в заданных диапазонах; значение, меньшее чем0, если в заданных диапазонах первый массив лексикографически меньше второго массива; и значение, большее чем0, если в заданных диапазонах первый массив лексикографически больше второго массива - Исключения:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов являетсяnull - С момента:
- 9
сравнение
public static <T> int compare(T[] a, T[] b, Comparator<? super T> cmp)
Object массива лексикографически с помощью заданного компаратора. Если два массива имеют общее префиксное совпадение, то лексикографическое сравнение является результатом сравнения с заданным компаратором двух элементов в соответствующих массивах с индексом, равным длине префикса. В противном случае один массив является надстрочным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух массивов. (См. mismatch(Object[], Object[]) для определения общего и надстрочного префикса.)
Ссылка на массив null считается лексикографически меньшей, чем ссылка на массив, не являющийся null. Две ссылки на null массивы считаются равными.
- Примечание API:
-
Этот метод ведет себя так, как будто (для ссылок на массивы, не являющиеся
null):int i = Arrays.mismatch(a, b, cmp); if (i >= 0 && i < Math.min(a.length, b.length)) return cmp.compare(a[i], b[i]); return a.length - b.length; - Параметры типа:
-
T- тип элементов массива - Параметры:
-
a- первый массив для сравнения -
b- второй массив для сравнения -
cmp- компаратор для сравнения элементов массива - Возвращает:
- значение
0, если первый и второй массивы равны и содержат одинаковые элементы в одинаковом порядке; значение, меньшее чем0, если первый массив лексикографически меньше второго массива; и значение, большее чем0, если первый массив лексикографически больше второго массива - Исключения:
-
NullPointerException- если компаратор являетсяnull - С момента:
- 9
сравнение
public static <T> int compare(T[] a, int aFromIndex, int aToIndex, T[] b, int bFromIndex, int bToIndex, Comparator<? super T> cmp)
Object массива лексикографически в заданных диапазонах. Если два массива в заданных диапазонах имеют общее префиксное совпадение, то лексикографическое сравнение является результатом сравнения с заданным компаратором двух элементов с относительным индексом в соответствующих массивах, равным длине префикса. В противном случае один массив является надстрочным префиксом другого, и лексикографическое сравнение является результатом сравнения длин двух диапазонов. (См. mismatch(Object[], int, int, Object[], int, int) для определения общего и надстрочного префикса.)
- Примечание API:
-
Этот метод ведет себя так, как будто (для элементов массива, не являющихся
null):int i = Arrays.mismatch(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex, cmp); if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex)) return cmp.compare(a[aFromIndex + i], b[bFromIndex + i]); return (aToIndex - aFromIndex) - (bToIndex - bFromIndex); - Параметры типа:
-
T- тип элементов массива - Параметры:
-
a- первый массив для сравнения -
aFromIndex- индекс (включительно) первого элемента в первом массиве для сравнения -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для сравнения -
b- второй массив для сравнения -
bFromIndex- индекс (включительно) первого элемента во втором массиве для сравнения -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для сравнения -
cmp- компаратор для сравнения элементов массива - Возвращает:
- значение
0, если в заданных диапазонах первый и второй массивы равны и содержат одинаковые элементы в одинаковом порядке; значение, меньшее чем0, если в заданных диапазонах первый массив лексикографически меньше второго массива; и значение, большее чем0, если в заданных диапазонах первый массив лексикографически больше второго массива - Исключения:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов или компаратор являетсяnull - С момента:
- 9
несоответствие
public static int mismatch(boolean[] a, boolean[] b)
boolean массивами, иначе возвращает -1, если несоответствие не найдено. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего массива. Если два массива имеют общее префиксное совпадение, то возвращаемый индекс равен длине общего префикса, и следует, что есть несовпадение между двумя элементами в этом индексе в соответствующих массивах. Если один массив является надстрочным префиксом другого, то возвращаемый индекс равен длине меньшего массива, и следует, что индекс действителен только для большего массива. В противном случае несоответствие отсутствует.
Два массива, не являющихся null, a и b, имеют общее префиксное совпадение длиной pl, если следующее выражение истинно:
pl >= 0 &&
pl < Math.min(a.length, b.length) &&
Arrays.equals(a, 0, pl, b, 0, pl) &&
a[pl] != b[pl]
Обратите внимание, что общая длина префикса 0 указывает на то, что первые элементы каждого массива не совпадают. Два массива, не являющиеся null, a и b, имеют надстрочный префикс, если следующее выражение истинно:
a.length != b.length &&
Arrays.equals(a, 0, Math.min(a.length, b.length),
b, 0, Math.min(a.length, b.length))
- Параметры:
-
a- первый массив, проверяемый на несовпадение -
b- второй массив, проверяемый на несовпадение - Возвращает:
- индекс первого несовпадения между двумя массивами, иначе
-1. - Исключения:
-
NullPointerException- если любой из массивов являетсяnull - С момента:
- 9
mismatch
public static int mismatch(boolean[] a, int aFromIndex, int aToIndex, boolean[] b, int bFromIndex, int bToIndex)
boolean массивами в указанных диапазонах, иначе возвращает -1, если несовпадение не найдено. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего диапазона. Если два массива в указанных диапазонах имеют общую префиксную часть, то возвращаемый относительный индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в этих массивах существует в этом относительном индексе. Если один массив является надмножеством другого в указанных диапазонах, то возвращаемый относительный индекс равен длине меньшего диапазона, и это означает, что относительный индекс действителен только для массива с большим диапазоном. В противном случае несовпадения нет.
Два не-null массива, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую префиксную часть длины pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex) &&
Arrays.equals(a, aFromIndex, aFromIndex + pl, b, bFromIndex, bFromIndex + pl) &&
a[aFromIndex + pl] != b[bFromIndex + pl]
Обратите внимание, что длина общей префиксной части 0 указывает на то, что первые элементы из каждого массива не совпадают. Два не-null массива, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую правильную префиксную часть, если выполняется следующее выражение:
(aToIndex - aFromIndex) != (bToIndex - bFromIndex) &&
Arrays.equals(a, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
b, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
- Parameters:
-
a- первый массив, проверяемый на несовпадение -
aFromIndex- индекс (включительно) первого элемента в первом массиве для проверки -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для проверки -
b- второй массив, проверяемый на несовпадение -
bFromIndex- индекс (включительно) первого элемента во втором массиве для проверки -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для проверки - Returns:
- относительный индекс первого несовпадения между двумя массивами в указанных диапазонах, иначе
-1. - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов являетсяnull - Since:
- 9
mismatch
public static int mismatch(byte[] a, byte[] b)
byte массивами, иначе возвращает -1, если несовпадение не найдено. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего массива. Если два массива имеют общую префиксную часть, то возвращаемый индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в соответствующих массивах находится в этом индексе. Если один массив является правильным префиксом другого, то возвращаемый индекс равен длине меньшего массива, и это означает, что индекс действителен только для большего массива. В противном случае несовпадения нет.
Два не-null массива, a и b, имеют общую префиксную часть длины pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(a.length, b.length) &&
Arrays.equals(a, 0, pl, b, 0, pl) &&
a[pl] != b[pl]
Обратите внимание, что длина общей префиксной части 0 указывает на то, что первые элементы из каждого массива не совпадают. Два не-null массива, a и b, имеют общую правильную префиксную часть, если выполняется следующее выражение:
a.length != b.length &&
Arrays.equals(a, 0, Math.min(a.length, b.length),
b, 0, Math.min(a.length, b.length))
- Parameters:
-
a- первый массив, проверяемый на несовпадение -
b- второй массив, проверяемый на несовпадение - Returns:
- индекс первого несовпадения между двумя массивами, иначе
-1. - Throws:
-
NullPointerException- если любой из массивов являетсяnull - Since:
- 9
mismatch
public static int mismatch(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex)
byte массивами в указанных диапазонах, иначе возвращает -1, если несовпадение не найдено. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего диапазона. Если два массива в указанных диапазонах имеют общую префиксную часть, то возвращаемый относительный индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в этих массивах существует в этом относительном индексе. Если один массив является надмножеством другого в указанных диапазонах, то возвращаемый относительный индекс равен длине меньшего диапазона, и это означает, что относительный индекс действителен только для массива с большим диапазоном. В противном случае несовпадения нет.
Два не-null массива, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую префиксную часть длины pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex) &&
Arrays.equals(a, aFromIndex, aFromIndex + pl, b, bFromIndex, bFromIndex + pl) &&
a[aFromIndex + pl] != b[bFromIndex + pl]
Обратите внимание, что длина общей префиксной части 0 указывает на то, что первые элементы из каждого массива не совпадают. Два не-null массива, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую правильную префиксную часть, если выполняется следующее выражение:
(aToIndex - aFromIndex) != (bToIndex - bFromIndex) &&
Arrays.equals(a, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
b, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
- Parameters:
-
a- первый массив, проверяемый на несовпадение -
aFromIndex- индекс (включительно) первого элемента в первом массиве для проверки -
aToIndex- индекс (исключительно) последнего элемента в первом массиве для проверки -
b- второй массив, проверяемый на несовпадение -
bFromIndex- индекс (включительно) первого элемента во втором массиве для проверки -
bToIndex- индекс (исключительно) последнего элемента во втором массиве для проверки - Returns:
- относительный индекс первого несовпадения между двумя массивами в указанных диапазонах, иначе
-1. - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов являетсяnull - Since:
- 9
mismatch
public static int mismatch(char[] a, char[] b)
char массивами, иначе возвращает -1, если несовпадение не найдено. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего массива. Если два массива имеют общую префиксную часть, то возвращаемый индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в соответствующих массивах находится в этом индексе. Если один массив является правильным префиксом другого, то возвращаемый индекс равен длине меньшего массива, и это означает, что индекс действителен только для большего массива. В противном случае несовпадения нет.
Два не-null массива, a и b, имеют общую префиксную часть длины pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(a.length, b.length) &&
Arrays.equals(a, 0, pl, b, 0, pl) &&
a[pl] != b[pl]
Обратите внимание, что длина общей префиксной части 0 указывает на то, что первые элементы из каждого массива не совпадают. Два не-null массива, a и b, имеют общую правильную префиксную часть, если выполняется следующее выражение:
a.length != b.length &&
Arrays.equals(a, 0, Math.min(a.length, b.length),
b, 0, Math.min(a.length, b.length))
- Parameters:
-
a- первый массив, проверяемый на несовпадение -
b- второй массив, проверяемый на несовпадение - Returns:
- индекс первого несовпадения между двумя массивами, иначе
-1. - Throws:
-
NullPointerException- если любой из массивов являетсяnull - Since:
- 9
mismatch
public static int mismatch(char[] a, int aFromIndex, int aToIndex, char[] b, int bFromIndex, int bToIndex)
char массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадения нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего диапазона. Если два массива в указанных диапазонах имеют общую префиксную часть, то возвращаемый относительный индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в соответствующих массивах находится в этом относительном индексе. Если один массив является правильным префиксом другого в указанных диапазонах, то возвращаемый относительный индекс равен длине меньшего диапазона, и это означает, что относительный индекс действителен только для массива с большим диапазоном. В противном случае несовпадения нет.
Два массива без null, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую префиксную часть длиной pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex) &&
Arrays.equals(a, aFromIndex, aFromIndex + pl, b, bFromIndex, bFromIndex + pl) &&
a[aFromIndex + pl] != b[bFromIndex + pl]
Обратите внимание, что длина общей префиксной части 0 указывает на то, что первые элементы из каждого массива не совпадают. Два массива без null, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют правильный префикс, если выполняется следующее выражение:
(aToIndex - aFromIndex) != (bToIndex - bFromIndex) &&
Arrays.equals(a, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
b, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
- Параметры:
-
a- первый массив, проверяемый на несовпадение -
aFromIndex- индекс (включительно) первого элемента в первом массиве, проверяемом на несовпадение -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, проверяемом на несовпадение -
b- второй массив, проверяемый на несовпадение -
bFromIndex- индекс (включительно) первого элемента во втором массиве, проверяемом на несовпадение -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, проверяемом на несовпадение - Возвращает:
- относительный индекс первого несовпадения между двумя массивами в указанных диапазонах, в противном случае
-1. - Исключения:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если один из массивовnull - С:
- 9
mismatch
public static int mismatch(short[] a, short[] b)
short массивами, в противном случае возвращает -1, если несовпадения нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего массива. Если два массива имеют общую префиксную часть, то возвращаемый индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в соответствующих массивах находится в этом индексе. Если один массив является правильным префиксом другого, то возвращаемый индекс равен длине меньшего массива, и это означает, что индекс действителен только для большего массива. В противном случае несовпадения нет.
Два массива без null, a и b, имеют общую префиксную часть длиной pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(a.length, b.length) &&
Arrays.equals(a, 0, pl, b, 0, pl) &&
a[pl] != b[pl]
Обратите внимание, что длина общей префиксной части 0 указывает на то, что первые элементы из каждого массива не совпадают. Два массива без null, a и b, имеют правильный префикс, если выполняется следующее выражение:
a.length != b.length &&
Arrays.equals(a, 0, Math.min(a.length, b.length),
b, 0, Math.min(a.length, b.length))
- Параметры:
-
a- первый массив, проверяемый на несовпадение -
b- второй массив, проверяемый на несовпадение - Возвращает:
- индекс первого несовпадения между двумя массивами, в противном случае
-1. - Исключения:
-
NullPointerException- если один из массивовnull - С:
- 9
mismatch
public static int mismatch(short[] a, int aFromIndex, int aToIndex, short[] b, int bFromIndex, int bToIndex)
short массивами в указанных диапазонах, в противном случае возвращает -1, если несовпадения нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего диапазона. Если два массива в указанных диапазонах имеют общую префиксную часть, то возвращаемый относительный индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в соответствующих массивах находится в этом относительном индексе. Если один массив является правильным префиксом другого в указанных диапазонах, то возвращаемый относительный индекс равен длине меньшего диапазона, и это означает, что относительный индекс действителен только для массива с большим диапазоном. В противном случае несовпадения нет.
Два массива без null, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую префиксную часть длиной pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex) &&
Arrays.equals(a, aFromIndex, aFromIndex + pl, b, bFromIndex, bFromIndex + pl) &&
a[aFromIndex + pl] != b[bFromIndex + pl]
Обратите внимание, что длина общей префиксной части 0 указывает на то, что первые элементы из каждого массива не совпадают. Два массива без null, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют правильный префикс, если выполняется следующее выражение:
(aToIndex - aFromIndex) != (bToIndex - bFromIndex) &&
Arrays.equals(a, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
b, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
- Параметры:
-
a- первый массив, проверяемый на несовпадение -
aFromIndex- индекс (включительно) первого элемента в первом массиве, проверяемом на несовпадение -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, проверяемом на несовпадение -
b- второй массив, проверяемый на несовпадение -
bFromIndex- индекс (включительно) первого элемента во втором массиве, проверяемом на несовпадение -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, проверяемом на несовпадение - Возвращает:
- относительный индекс первого несовпадения между двумя массивами в указанных диапазонах, в противном случае
-1. - Исключения:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если один из массивовnull - С:
- 9
mismatch
public static int mismatch(int[] a, int[] b)
int массивами, в противном случае возвращает -1, если несовпадения нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего массива. Если два массива имеют общую префиксную часть, то возвращаемый индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в соответствующих массивах находится в этом индексе. Если один массив является правильным префиксом другого, то возвращаемый индекс равен длине меньшего массива, и это означает, что индекс действителен только для большего массива. В противном случае несовпадения нет.
Два массива без null, a и b, имеют общую префиксную часть длиной pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(a.length, b.length) &&
Arrays.equals(a, 0, pl, b, 0, pl) &&
a[pl] != b[pl]
Обратите внимание, что длина общей префиксной части 0 указывает на то, что первые элементы из каждого массива не совпадают. Два массива без null, a и b, имеют правильный префикс, если выполняется следующее выражение:
a.length != b.length &&
Arrays.equals(a, 0, Math.min(a.length, b.length),
b, 0, Math.min(a.length, b.length))
- Параметры:
-
a- первый массив, проверяемый на несовпадение -
b- второй массив, проверяемый на несовпадение - Возвращает:
- индекс первого несовпадения между двумя массивами, в противном случае
-1. - Исключения:
-
NullPointerException- если один из массивовnull - С:
- 9
mismatch
public static int mismatch(int[] a, int aFromIndex, int aToIndex, int[] b, int bFromIndex, int bToIndex)
int массивами в заданных диапазонах, иначе возвращает -1, если несовпадений нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего диапазона. Если два массива в заданных диапазонах имеют общую префиксную часть, то возвращаемый относительный индекс равен длине этой общей префиксной части, и это означает, что несовпадение между элементами в соответствующих массивах происходит при этом относительном индексе. Если один массив является правильным префиксом другого в заданных диапазонах, то возвращаемый относительный индекс равен длине меньшего диапазона, и это означает, что относительный индекс действителен только для массива с большим диапазоном. В противном случае несовпадения нет.
Два не-null массива, a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую префиксную часть длины pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex) &&
Arrays.equals(a, aFromIndex, aFromIndex + pl, b, bFromIndex, bFromIndex + pl) &&
a[aFromIndex + pl] != b[bFromIndex + pl]
Обратите внимание, что общая длина префикса 0 указывает на то, что первые элементы каждого массива не совпадают. Два не-null массива, a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют правильный префикс, если выполняется следующее выражение:
(aToIndex - aFromIndex) != (bToIndex - bFromIndex) &&
Arrays.equals(a, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
b, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
- Параметры:
-
a- первый массив, который проверяется на несовпадение -
aFromIndex- индекс (включительно) первого элемента в первом массиве, который проверяется -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, который проверяется -
b- второй массив, который проверяется на несовпадение -
bFromIndex- индекс (включительно) первого элемента во втором массиве, который проверяется -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, который проверяется - Возвращает:
- относительный индекс первого несовпадения между двумя массивами в заданных диапазонах, иначе
-1. - Выбрасывает:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - С тех пор как:
- 9
mismatch
public static int mismatch(long[] a, long[] b)
long массивами, иначе возвращает -1, если несовпадений нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего массива. Если два массива имеют общую префиксную часть, то возвращаемый индекс равен длине этой общей префиксной части, и это означает, что несовпадение между элементами в соответствующих массивах происходит при этом индексе. Если один массив является правильным префиксом другого, то возвращаемый индекс равен длине меньшего массива, и это означает, что индекс действителен только для большего массива. В противном случае несовпадения нет.
Два не-null массива, a и b, имеют общую префиксную часть длины pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(a.length, b.length) &&
Arrays.equals(a, 0, pl, b, 0, pl) &&
a[pl] != b[pl]
Обратите внимание, что общая длина префикса 0 указывает на то, что первые элементы каждого массива не совпадают. Два не-null массива, a и b, имеют правильный префикс, если выполняется следующее выражение:
a.length != b.length &&
Arrays.equals(a, 0, Math.min(a.length, b.length),
b, 0, Math.min(a.length, b.length))
- Параметры:
-
a- первый массив, который проверяется на несовпадение -
b- второй массив, который проверяется на несовпадение - Возвращает:
- индекс первого несовпадения между двумя массивами, иначе
-1. - Выбрасывает:
-
NullPointerException- если любой из массивовnull - С тех пор как:
- 9
mismatch
public static int mismatch(long[] a, int aFromIndex, int aToIndex, long[] b, int bFromIndex, int bToIndex)
long массивами в заданных диапазонах, иначе возвращает -1, если несовпадений нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего диапазона. Если два массива в заданных диапазонах имеют общую префиксную часть, то возвращаемый относительный индекс равен длине этой общей префиксной части, и это означает, что несовпадение между элементами в соответствующих массивах происходит при этом относительном индексе. Если один массив является правильным префиксом другого в заданных диапазонах, то возвращаемый относительный индекс равен длине меньшего диапазона, и это означает, что относительный индекс действителен только для массива с большим диапазоном. В противном случае несовпадения нет.
Два не-null массива, a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую префиксную часть длины pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex) &&
Arrays.equals(a, aFromIndex, aFromIndex + pl, b, bFromIndex, bFromIndex + pl) &&
a[aFromIndex + pl] != b[bFromIndex + pl]
Обратите внимание, что общая длина префикса 0 указывает на то, что первые элементы каждого массива не совпадают. Два не-null массива, a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют правильный префикс, если выполняется следующее выражение:
(aToIndex - aFromIndex) != (bToIndex - bFromIndex) &&
Arrays.equals(a, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
b, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
- Параметры:
-
a- первый массив, который проверяется на несовпадение -
aFromIndex- индекс (включительно) первого элемента в первом массиве, который проверяется -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, который проверяется -
b- второй массив, который проверяется на несовпадение -
bFromIndex- индекс (включительно) первого элемента во втором массиве, который проверяется -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, который проверяется - Возвращает:
- относительный индекс первого несовпадения между двумя массивами в заданных диапазонах, иначе
-1. - Выбрасывает:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - С тех пор как:
- 9
mismatch
public static int mismatch(float[] a, float[] b)
float массивами, иначе возвращает -1, если несовпадений нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего массива. Если два массива имеют общую префиксную часть, то возвращаемый индекс равен длине этой общей префиксной части, и это означает, что несовпадение между элементами в соответствующих массивах происходит при этом индексе. Если один массив является правильным префиксом другого, то возвращаемый индекс равен длине меньшего массива, и это означает, что индекс действителен только для большего массива. В противном случае несовпадения нет.
Два не-null массива, a и b, имеют общую префиксную часть длины pl, если выполняется следующее выражение:
pl >= 0 &&
pl < Math.min(a.length, b.length) &&
Arrays.equals(a, 0, pl, b, 0, pl) &&
Float.compare(a[pl], b[pl]) != 0
Обратите внимание, что общая длина префикса 0 указывает на то, что первые элементы каждого массива не совпадают. Два не-null массива, a и b, имеют правильный префикс, если выполняется следующее выражение:
a.length != b.length &&
Arrays.equals(a, 0, Math.min(a.length, b.length),
b, 0, Math.min(a.length, b.length))
- Параметры:
-
a- первый массив, который проверяется на несовпадение -
b- второй массив, который проверяется на несовпадение - Возвращает:
- индекс первого несовпадения между двумя массивами, иначе
-1. - Выбрасывает:
-
NullPointerException- если любой из массивовnull - С тех пор как:
- 9
mismatch
public static int mismatch(float[] a, int aFromIndex, int aToIndex, float[] b, int bFromIndex, int bToIndex)
float массивами в указанных диапазонах, иначе возвращает -1, если несовпадения нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего диапазона. Если два массива в указанных диапазонах имеют общую префиксную часть, то возвращаемый относительный индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в этих массивах находится по этому относительному индексу. Если один массив является правильным префиксом другого в указанных диапазонах, то возвращаемый относительный индекс равен длине меньшего диапазона, и это означает, что относительный индекс действителен только для массива с большим диапазоном. В противном случае несовпадения нет.
Два не-null массива, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую префиксную часть длины pl, если следующее выражение истинно:
pl >= 0 &&
pl < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex) &&
Arrays.equals(a, aFromIndex, aFromIndex + pl, b, bFromIndex, bFromIndex + pl) &&
Float.compare(a[aFromIndex + pl], b[bFromIndex + pl]) != 0
Обратите внимание, что длина общей префиксной части 0 указывает на несовпадение первых элементов каждого массива. Два не-null массива, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют правильную префиксную часть, если следующее выражение истинно:
(aToIndex - aFromIndex) != (bToIndex - bFromIndex) &&
Arrays.equals(a, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
b, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
- Параметры:
-
a- первый массив, проверяемый на несовпадение -
aFromIndex- индекс (включительно) первого элемента в первом массиве, подлежащем проверке -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, подлежащем проверке -
b- второй массив, проверяемый на несовпадение -
bFromIndex- индекс (включительно) первого элемента во втором массиве, подлежащем проверке -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, подлежащем проверке - Возвращает:
- относительный индекс первого несовпадения между двумя массивами в указанных диапазонах, иначе
-1. - Исключения:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - С момента:
- 9
mismatch
public static int mismatch(double[] a, double[] b)
double массивами, иначе возвращает -1, если несовпадения нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего массива. Если два массива имеют общую префиксную часть, то возвращаемый индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в этих массивах находится по этому индексу. Если один массив является правильным префиксом другого, то возвращаемый индекс равен длине меньшего массива, и это означает, что индекс действителен только для большего массива. В противном случае несовпадения нет.
Два не-null массива, a и b, имеют общую префиксную часть длины pl, если следующее выражение истинно:
pl >= 0 &&
pl < Math.min(a.length, b.length) &&
Arrays.equals(a, 0, pl, b, 0, pl) &&
Double.compare(a[pl], b[pl]) != 0
Обратите внимание, что длина общей префиксной части 0 указывает на несовпадение первых элементов каждого массива. Два не-null массива, a и b, имеют правильную префиксную часть, если следующее выражение истинно:
a.length != b.length &&
Arrays.equals(a, 0, Math.min(a.length, b.length),
b, 0, Math.min(a.length, b.length))
- Параметры:
-
a- первый массив, проверяемый на несовпадение -
b- второй массив, проверяемый на несовпадение - Возвращает:
- индекс первого несовпадения между двумя массивами, иначе
-1. - Исключения:
-
NullPointerException- если любой из массивовnull - С момента:
- 9
mismatch
public static int mismatch(double[] a, int aFromIndex, int aToIndex, double[] b, int bFromIndex, int bToIndex)
double массивами в указанных диапазонах, иначе возвращает -1, если несовпадения нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего диапазона. Если два массива в указанных диапазонах имеют общую префиксную часть, то возвращаемый относительный индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в этих массивах находится по этому относительному индексу. Если один массив является правильным префиксом другого в указанных диапазонах, то возвращаемый относительный индекс равен длине меньшего диапазона, и это означает, что относительный индекс действителен только для массива с большим диапазоном. В противном случае несовпадения нет.
Два не-null массива, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую префиксную часть длины pl, если следующее выражение истинно:
pl >= 0 &&
pl < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex) &&
Arrays.equals(a, aFromIndex, aFromIndex + pl, b, bFromIndex, bFromIndex + pl) &&
Double.compare(a[aFromIndex + pl], b[bFromIndex + pl]) != 0
Обратите внимание, что длина общей префиксной части 0 указывает на несовпадение первых элементов каждого массива. Два не-null массива, a и b с указанными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют правильную префиксную часть, если следующее выражение истинно:
(aToIndex - aFromIndex) != (bToIndex - bFromIndex) &&
Arrays.equals(a, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
b, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
- Параметры:
-
a- первый массив, проверяемый на несовпадение -
aFromIndex- индекс (включительно) первого элемента в первом массиве, подлежащем проверке -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, подлежащем проверке -
b- второй массив, проверяемый на несовпадение -
bFromIndex- индекс (включительно) первого элемента во втором массиве, подлежащем проверке -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, подлежащем проверке - Возвращает:
- относительный индекс первого несовпадения между двумя массивами в указанных диапазонах, иначе
-1. - Исключения:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивовnull - С момента:
- 9
mismatch
public static int mismatch(Object[] a, Object[] b)
Object массивами, иначе возвращает -1, если несовпадения нет. Индекс будет в диапазоне от 0 (включительно) до длины (включительно) меньшего массива. Если два массива имеют общую префиксную часть, то возвращаемый индекс равен длине общей префиксной части, и это означает, что несовпадение между двумя элементами в этих массивах находится по этому индексу. Если один массив является правильным префиксом другого, то возвращаемый индекс равен длине меньшего массива, и это означает, что индекс действителен только для большего массива. В противном случае несовпадения нет.
Два не-null массива, a и b, имеют общую префиксную часть длины pl, если следующее выражение истинно:
pl >= 0 &&
pl < Math.min(a.length, b.length) &&
Arrays.equals(a, 0, pl, b, 0, pl) &&
!Objects.equals(a[pl], b[pl])
Обратите внимание, что длина общей префиксной части 0 указывает на несовпадение первых элементов каждого массива. Два не-null массива, a и b, имеют правильную префиксную часть, если следующее выражение истинно:
a.length != b.length &&
Arrays.equals(a, 0, Math.min(a.length, b.length),
b, 0, Math.min(a.length, b.length))
- Параметры:
-
a- первый массив, проверяемый на несовпадение -
b- второй массив, проверяемый на несовпадение - Возвращает:
- индекс первого несовпадения между двумя массивами, иначе
-1. - Исключения:
-
NullPointerException- если любой из массивовnull - С момента:
- 9
mismatch
public static int mismatch(Object[] a, int aFromIndex, int aToIndex, Object[] b, int bFromIndex, int bToIndex)
Object массивами в заданных диапазонах, в противном случае возвращает -1, если несовпадение не найдено. Индекс будет находиться в диапазоне от 0 (включительно) до длины (включительно) меньшего диапазона. Если два массива в заданных диапазонах имеют общую префиксную часть, то возвращаемый относительный индекс равен длине общей префиксной части, и это означает, что несовпадение наблюдается между двумя элементами в этом относительном индексе в соответствующих массивах. Если один массив является правильным префиксом другого в заданных диапазонах, то возвращаемый относительный индекс равен длине меньшего диапазона, и это означает, что относительный индекс действителен только для массива с большим диапазоном. В противном случае несовпадения нет.
Два не-null массива, a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую префиксную часть длины pl, если следующее выражение истинно:
pl >= 0 &&
pl < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex) &&
Arrays.equals(a, aFromIndex, aFromIndex + pl, b, bFromIndex, bFromIndex + pl) &&
!Objects.equals(a[aFromIndex + pl], b[bFromIndex + pl])
Обратите внимание, что общая длина префикса 0 указывает на то, что первые элементы каждого массива не совпадают. Два не-null массива, a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют правильный префикс, если следующее выражение истинно:
(aToIndex - aFromIndex) != (bToIndex - bFromIndex) &&
Arrays.equals(a, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
b, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
- Parameters:
-
a- первый массив, проверяемый на несовпадение -
aFromIndex- индекс (включительно) первого элемента в первом массиве, который проверяется -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, который проверяется -
b- второй массив, проверяемый на несовпадение -
bFromIndex- индекс (включительно) первого элемента во втором массиве, который проверяется -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, который проверяется - Returns:
- относительный индекс первого несовпадения между двумя массивами в заданных диапазонах, в противном случае
-1. - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов являетсяnull - Since:
- 9
mismatch
public static <T> int mismatch(T[] a, T[] b, Comparator<? super T> cmp)
Object массивами, в противном случае возвращает -1, если несовпадение не найдено. Индекс будет находиться в диапазоне от 0 (включительно) до длины (включительно) меньшего массива. Указанный компаратор используется для определения, равны ли два элемента массива из каждого массива.
Если два массива имеют общую префиксную часть, то возвращаемый индекс равен длине общей префиксной части, и это означает, что несовпадение наблюдается между двумя элементами в этом индексе в соответствующих массивах. Если один массив является правильным префиксом другого, то возвращаемый индекс равен длине меньшего массива, и это означает, что индекс действителен только для большего массива. В противном случае несовпадения нет.
Два не-null массива, a и b, имеют общую префиксную часть длины pl, если следующее выражение истинно:
pl >= 0 &&
pl < Math.min(a.length, b.length) &&
Arrays.equals(a, 0, pl, b, 0, pl, cmp)
cmp.compare(a[pl], b[pl]) != 0
Обратите внимание, что общая длина префикса 0 указывает на то, что первые элементы каждого массива не совпадают. Два не-null массива, a и b, имеют правильный префикс, если следующее выражение истинно:
a.length != b.length &&
Arrays.equals(a, 0, Math.min(a.length, b.length),
b, 0, Math.min(a.length, b.length),
cmp)
- Type Parameters:
-
T- тип элементов массива - Parameters:
-
a- первый массив, проверяемый на несовпадение -
b- второй массив, проверяемый на несовпадение -
cmp- компаратор для сравнения элементов массива - Returns:
- индекс первого несовпадения между двумя массивами, в противном случае
-1. - Throws:
-
NullPointerException- если любой из массивов или компаратор являетсяnull - Since:
- 9
mismatch
public static <T> int mismatch(T[] a, int aFromIndex, int aToIndex, T[] b, int bFromIndex, int bToIndex, Comparator<? super T> cmp)
Object массивами в заданных диапазонах, в противном случае возвращает -1, если несовпадение не найдено. Индекс будет находиться в диапазоне от 0 (включительно) до длины (включительно) меньшего диапазона. Если два массива в заданных диапазонах имеют общую префиксную часть, то возвращаемый относительный индекс равен длине общей префиксной части, и это означает, что несовпадение наблюдается между двумя элементами в этом относительном индексе в соответствующих массивах. Если один массив является правильным префиксом другого в заданных диапазонах, то возвращаемый относительный индекс равен длине меньшего диапазона, и это означает, что относительный индекс действителен только для массива с большим диапазоном. В противном случае несовпадения нет.
Два не-null массива, a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют общую префиксную часть длины pl, если следующее выражение истинно:
pl >= 0 &&
pl < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex) &&
Arrays.equals(a, aFromIndex, aFromIndex + pl, b, bFromIndex, bFromIndex + pl, cmp) &&
cmp.compare(a[aFromIndex + pl], b[bFromIndex + pl]) != 0
Обратите внимание, что общая длина префикса 0 указывает на то, что первые элементы каждого массива не совпадают. Два не-null массива, a и b с заданными диапазонами [aFromIndex, atoIndex) и [bFromIndex, btoIndex) соответственно, имеют правильный префикс, если следующее выражение истинно:
(aToIndex - aFromIndex) != (bToIndex - bFromIndex) &&
Arrays.equals(a, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
b, 0, Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex),
cmp)
- Type Parameters:
-
T- тип элементов массива - Parameters:
-
a- первый массив, проверяемый на несовпадение -
aFromIndex- индекс (включительно) первого элемента в первом массиве, который проверяется -
aToIndex- индекс (исключительно) последнего элемента в первом массиве, который проверяется -
b- второй массив, проверяемый на несовпадение -
bFromIndex- индекс (включительно) первого элемента во втором массиве, который проверяется -
bToIndex- индекс (исключительно) последнего элемента во втором массиве, который проверяется -
cmp- компаратор для сравнения элементов массива - Returns:
- относительный индекс первого несовпадения между двумя массивами в заданных диапазонах, в противном случае
-1. - Throws:
-
IllegalArgumentException- еслиaFromIndex > aToIndexили еслиbFromIndex > bToIndex -
ArrayIndexOutOfBoundsException- еслиaFromIndex < 0 or aToIndex > a.lengthили еслиbFromIndex < 0 or bToIndex > b.length -
NullPointerException- если любой из массивов или компаратор являетсяnull - Since:
- 9
© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/Arrays.html