Класс Arrays

public static void sort(int[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

public static void sort(long[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

public static void sort(short[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

public static void sort(char[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

public static void sort(byte[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

public static void sort(float[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

public static void sort(double[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

public static void parallelSort(byte[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

Начиная с версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

Начиная с версии:

1.8

public static void parallelSort(char[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

Начиная с версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

Начиная с версии:

1.8

public static void parallelSort(short[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

Начиная с версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

Начиная с версии:

1.8

public static void parallelSort(int[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

Начиная с версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

Начиная с версии:

1.8

public static void parallelSort(long[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

Начиная с версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

Начиная с версии:

1.8

public static void parallelSort(float[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

Начиная с версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

Начиная с версии:

1.8

public static void parallelSort(double[] a)

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

Начиная с версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки — быстрая сортировка с двумя опорными элементами, разработанная Владимиром Ярославским, Джоном Бентли и Джошуа Блохом. Этот алгоритм обеспечивает производительность O(n log(n)) для всех наборов данных и обычно работает быстрее традиционных реализаций быстрой сортировки с одним опорным элементом.

Параметры:

a — массив для сортировки

fromIndex — индекс первого сортируемого элемента включительно

toIndex — индекс последнего сортируемого элемента, не включительно

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

Начиная с версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки представляет собой параллельную сортировку слиянием: массив разбивается на подмассивы, которые сортируются отдельно, а затем объединяются. Когда длина подмассива достигает минимальной гранулярности, подмассив сортируется с помощью соответствующего метода Arrays.sort. Если длина указанного массива меньше минимальной гранулярности, он сортируется с помощью соответствующего метода Arrays.sort. Алгоритму требуется рабочая область размером не более исходного массива. Для выполнения параллельных задач используется ForkJoin common pool.

Параметры типа:

T — класс сортируемых объектов

Параметры:

a — сортируемый массив

Исключения:

ClassCastException — если массив содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа)

IllegalArgumentException — (необязательное) если обнаружено, что естественный порядок элементов массива нарушает контракт Comparable

С версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки представляет собой параллельную сортировку слиянием: массив разбивается на подмассивы, которые сортируются отдельно, а затем объединяются. Когда длина подмассива достигает минимальной гранулярности, подмассив сортируется с помощью соответствующего метода Arrays.sort. Если длина указанного массива меньше минимальной гранулярности, он сортируется с помощью соответствующего метода Arrays.sort. Алгоритму требуется рабочая область размером не более указанного диапазона исходного массива. Для выполнения параллельных задач используется ForkJoin common pool.

Параметры типа:

T — класс сортируемых объектов

Параметры:

a — сортируемый массив

fromIndex — индекс первого сортируемого элемента (включительно)

toIndex — индекс последнего сортируемого элемента (исключительно)

Исключения:

IllegalArgumentException — если fromIndex > toIndex или (необязательно) если обнаружено, что естественный порядок элементов массива нарушает контракт Comparable

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

ClassCastException — если массив содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа).

С версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки представляет собой параллельную сортировку слиянием: массив разбивается на подмассивы, которые сортируются отдельно, а затем объединяются. Когда длина подмассива достигает минимальной гранулярности, подмассив сортируется с помощью соответствующего метода Arrays.sort. Если длина указанного массива меньше минимальной гранулярности, он сортируется с помощью соответствующего метода Arrays.sort. Алгоритму требуется рабочая область размером не более исходного массива. Для выполнения параллельных задач используется ForkJoin common pool.

Параметры типа:

T — класс сортируемых объектов

Параметры:

a — сортируемый массив

cmp — компаратор, задающий порядок элементов массива. Значение null указывает, что следует использовать естественный порядок элементов.

Исключения:

ClassCastException — если массив содержит элементы, которые не являются взаимно сравнимыми с помощью указанного компаратора

IllegalArgumentException — (необязательное) если обнаружено, что компаратор нарушает контракт Comparator

С версии:

1.8

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

Примечание по реализации:

Алгоритм сортировки представляет собой параллельную сортировку слиянием: массив разбивается на подмассивы, которые сортируются отдельно, а затем объединяются. Когда длина подмассива достигает минимальной гранулярности, подмассив сортируется с помощью соответствующего метода Arrays.sort. Если длина указанного массива меньше минимальной гранулярности, он сортируется с помощью соответствующего метода Arrays.sort. Алгоритму требуется рабочая область размером не более указанного диапазона исходного массива. Для выполнения параллельных задач используется ForkJoin common pool.

Параметры типа:

T — класс сортируемых объектов

Параметры:

a — сортируемый массив

fromIndex — индекс первого сортируемого элемента (включительно)

toIndex — индекс последнего сортируемого элемента (исключительно)

cmp — компаратор, задающий порядок элементов массива. Значение null указывает, что следует использовать естественный порядок элементов.

Исключения:

IllegalArgumentException — если fromIndex > toIndex или (необязательно) если обнаружено, что естественный порядок элементов массива нарушает контракт Comparable

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

ClassCastException — если массив содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа).

С версии:

1.8

public static void sort(Object[] a)

Параметры:

a — сортируемый массив

Исключения:

ClassCastException — если массив содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа)

IllegalArgumentException — (необязательное) если обнаружено, что естественный порядок элементов массива нарушает контракт Comparable

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

Параметры:

a — сортируемый массив

fromIndex — индекс первого сортируемого элемента (включительно)

toIndex — индекс последнего сортируемого элемента (исключительно)

Исключения:

IllegalArgumentException — если fromIndex > toIndex или (необязательно) если обнаружено, что естественный порядок элементов массива нарушает контракт Comparable

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

ClassCastException — если массив содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа).

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

Параметры типа:

T — класс сортируемых объектов

Параметры:

a — сортируемый массив

c — компаратор, задающий порядок элементов массива. Значение null указывает, что следует использовать естественный порядок элементов.

Исключения:

ClassCastException — если массив содержит элементы, которые не являются взаимно сравнимыми с помощью указанного компаратора

IllegalArgumentException — (необязательное) если обнаружено, что компаратор нарушает контракт Comparator

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

Параметры типа:

T — класс сортируемых объектов

Параметры:

a — сортируемый массив

fromIndex — индекс первого сортируемого элемента (включительно)

toIndex — индекс последнего сортируемого элемента (исключительно)

c — компаратор, задающий порядок элементов массива. Значение null указывает, что следует использовать естественный порядок элементов.

Исключения:

ClassCastException — если массив содержит элементы, которые не являются взаимно сравнимыми с помощью указанного компаратора.

IllegalArgumentException — если fromIndex > toIndex или (необязательно) если обнаружено, что компаратор нарушает контракт Comparator

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

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

Параметры типа:

T — класс объектов в массиве

Параметры:

array — массив, который этот метод изменяет на месте

op — функция без побочных эффектов и с ассоциативной операцией для накопления значений

Исключения:

NullPointerException — если указанный массив или функция равны null

С версии:

1.8

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

Параметры типа:

T — класс объектов в массиве

Параметры:

array — массив

fromIndex — индекс первого элемента включительно

toIndex — индекс последнего элемента исключительно

op — функция без побочных эффектов и с ассоциативной операцией для накопления значений

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > array.length

NullPointerException — если указанный массив или функция равны null

С версии:

1.8

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

Параметры:

array — массив, который этот метод изменяет на месте

op — функция без побочных эффектов и с ассоциативной операцией для накопления значений

Исключения:

NullPointerException — если указанный массив или функция равны null

С версии:

1.8

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

Параметры:

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)

Параметры:

array — массив, который этот метод изменяет на месте

op — функция без побочных эффектов для накопления значений

Исключения:

NullPointerException — если указанный массив или функция равны null

С версии:

1.8

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

Параметры:

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)

Параметры:

array — массив, который этот метод изменяет на месте

op — функция без побочных эффектов и с ассоциативной операцией для накопления значений

Исключения:

NullPointerException — если указанный массив или функция равны null

С версии:

1.8

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

Параметры:

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)

Параметры:

a — массив для поиска

key — искомое значение

Возвращает:

индекс ключа поиска, если он содержится в массиве; в противном случае — (-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, или a.length, если все элементы массива меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.

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

Параметры:

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)

Параметры:

a — массив для поиска

key — искомое значение

Возвращает:

индекс ключа поиска, если он содержится в массиве; в противном случае — (-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, или a.length, если все элементы массива меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.

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

Параметры:

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)

Параметры:

a — массив для поиска

key — искомое значение

Возвращает:

индекс ключа поиска, если он содержится в массиве; в противном случае — (-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, или a.length, если все элементы массива меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.

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

Параметры:

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)

Параметры:

a — массив для поиска

key — искомое значение

Возвращает:

индекс ключа поиска, если он содержится в массиве; в противном случае — (-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, или a.length, если все элементы массива меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.

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

Параметры:

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)

Параметры:

a — массив для поиска

key — искомое значение

Возвращает:

индекс ключа поиска, если он содержится в массиве; в противном случае — (-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, или a.length, если все элементы массива меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.

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

Параметры:

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)

Параметры:

a — массив для поиска

key — искомое значение

Возвращает:

индекс ключа поиска, если он содержится в массиве; в противном случае — (-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, или a.length, если все элементы массива меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.

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

Параметры:

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)

Параметры:

a — массив для поиска

key — искомое значение

Возвращает:

индекс ключа поиска, если он содержится в массиве; в противном случае — (-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, или a.length, если все элементы массива меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.

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

Параметры:

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)

Параметры:

a — массив для поиска

key — искомое значение

Возвращает:

индекс ключа поиска, если он содержится в массиве; в противном случае — (-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в массив: индекс первого элемента, большего ключа, или a.length, если все элементы массива меньше указанного ключа. Это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.

Выбрасывает:

ClassCastException — если ключ поиска нельзя сравнить с элементами массива.

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

Параметры:

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)

Параметры типа:

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)

Параметры типа:

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

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

Параметры:

a — один массив для проверки на равенство

a2 — другой массив для проверки на равенство

Возвращает:

true, если два массива равны

public static boolean equals(long[] a, int aFromIndex, int aToIndex, long[] b, int bFromIndex, int bToIndex)

Параметры:

a — первый массив для проверки на равенство

aFromIndex — индекс (включительно) первого проверяемого элемента первого массива

aToIndex — индекс (не включительно) последнего проверяемого элемента первого массива

b — второй массив для проверки на равенство

bFromIndex — индекс (включительно) первого проверяемого элемента второго массива

bToIndex — индекс (не включительно) последнего проверяемого элемента второго массива

Возвращает:

true, если два массива равны в указанных диапазонах

Выбрасывает:

IllegalArgumentException — если aFromIndex > aToIndex или если bFromIndex > bToIndex

ArrayIndexOutOfBoundsException — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если любой из массивов имеет значение null

Начиная с:

9

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

Параметры:

a — один массив для проверки на равенство

a2 — другой массив для проверки на равенство

Возвращает:

true, если два массива равны

public static boolean equals(int[] a, int aFromIndex, int aToIndex, int[] b, int bFromIndex, int bToIndex)

Параметры:

a — первый массив для проверки на равенство

aFromIndex — индекс (включительно) первого проверяемого элемента в первом массиве

aToIndex — индекс (не включительно) последнего проверяемого элемента в первом массиве

b — второй массив для проверки на равенство

bFromIndex — индекс (включительно) первого проверяемого элемента во втором массиве

bToIndex — индекс (не включительно) последнего проверяемого элемента во втором массиве

Возвращает:

true, если два массива равны в указанных диапазонах

Исключения:

IllegalArgumentException — если aFromIndex > aToIndex или если bFromIndex > bToIndex

ArrayIndexOutOfBoundsException — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если один из массивов null

Начиная с версии:

9

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

Параметры:

a — один массив для проверки на равенство

a2 — другой массив для проверки на равенство

Возвращает:

true, если два массива равны

public static boolean equals(short[] a, int aFromIndex, int aToIndex, short[] b, int bFromIndex, int bToIndex)

Параметры:

a — первый массив для проверки на равенство

aFromIndex — индекс (включительно) первого проверяемого элемента в первом массиве

aToIndex — индекс (не включительно) последнего проверяемого элемента в первом массиве

b — второй массив для проверки на равенство

bFromIndex — индекс (включительно) первого проверяемого элемента во втором массиве

bToIndex — индекс (не включительно) последнего проверяемого элемента во втором массиве

Возвращает:

true, если два массива равны в указанных диапазонах

Исключения:

IllegalArgumentException — если aFromIndex > aToIndex или если bFromIndex > bToIndex

ArrayIndexOutOfBoundsException — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если один из массивов null

Начиная с версии:

9

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

Параметры:

a — один массив для проверки на равенство

a2 — другой массив для проверки на равенство

Возвращает:

true, если два массива равны

public static boolean equals(char[] a, int aFromIndex, int aToIndex, char[] b, int bFromIndex, int bToIndex)

Параметры:

a — первый массив для проверки на равенство

aFromIndex — индекс (включительно) первого проверяемого элемента в первом массиве

aToIndex — индекс (не включительно) последнего проверяемого элемента в первом массиве

b — второй массив для проверки на равенство

bFromIndex — индекс (включительно) первого проверяемого элемента во втором массиве

bToIndex — индекс (не включительно) последнего проверяемого элемента во втором массиве

Возвращает:

true, если два массива равны в указанных диапазонах

Исключения:

IllegalArgumentException — если aFromIndex > aToIndex или если bFromIndex > bToIndex

ArrayIndexOutOfBoundsException — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если один из массивов null

Начиная с версии:

9

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

Параметры:

a — один массив для проверки на равенство

a2 — другой массив для проверки на равенство

Возвращает:

true, если два массива равны

public static boolean equals(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex)

Параметры:

a — первый массив для проверки на равенство

aFromIndex — индекс (включительно) первого проверяемого элемента в первом массиве

aToIndex — индекс (не включительно) последнего проверяемого элемента в первом массиве

b — второй массив для проверки на равенство

bFromIndex — индекс (включительно) первого проверяемого элемента во втором массиве

bToIndex — индекс (не включительно) последнего проверяемого элемента во втором массиве

Возвращает:

true, если два массива равны в указанных диапазонах

Исключения:

IllegalArgumentException — если aFromIndex > aToIndex или если bFromIndex > bToIndex

ArrayIndexOutOfBoundsException — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если один из массивов null

Начиная с версии:

9

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

Параметры:

a — один массив для проверки на равенство

a2 — другой массив для проверки на равенство

Возвращает:

true, если два массива равны

public static boolean equals(boolean[] a, int aFromIndex, int aToIndex, boolean[] b, int bFromIndex, int bToIndex)

Параметры:

a — первый массив для проверки на равенство

aFromIndex — индекс (включительно) первого проверяемого элемента в первом массиве

aToIndex — индекс (не включительно) последнего проверяемого элемента в первом массиве

b — второй массив для проверки на равенство

bFromIndex — индекс (включительно) первого проверяемого элемента во втором массиве

bToIndex — индекс (не включительно) последнего проверяемого элемента во втором массиве

Возвращает:

true, если два массива равны в указанных диапазонах

Исключения:

IllegalArgumentException — если aFromIndex > aToIndex или если bFromIndex > bToIndex

ArrayIndexOutOfBoundsException — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если один из массивов null

Начиная с версии:

9

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

    Double.valueOf(d1).equals(Double.valueOf(d2))

Параметры:

a — один массив для проверки на равенство

a2 — другой массив для проверки на равенство

Возвращает:

true, если два массива равны

См. также:

• Double.equals(Object)

public static boolean equals(double[] a, int aFromIndex, int aToIndex, double[] b, int bFromIndex, int bToIndex)

    Double.valueOf(d1).equals(Double.valueOf(d2))

Параметры:

a — первый массив для проверки на равенство

aFromIndex — индекс (включительно) первого проверяемого элемента в первом массиве

aToIndex — индекс (не включительно) последнего проверяемого элемента в первом массиве

b — второй массив для проверки на равенство

bFromIndex — индекс (включительно) первого проверяемого элемента во втором массиве

bToIndex — индекс (не включительно) последнего проверяемого элемента во втором массиве

Возвращает:

true, если два массива равны в указанных диапазонах

Исключения:

IllegalArgumentException — если aFromIndex > aToIndex или если bFromIndex > bToIndex

ArrayIndexOutOfBoundsException — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если один из массивов null

Начиная с версии:

9

См. также:

• Double.equals(Object)

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

    Float.valueOf(f1).equals(Float.valueOf(f2))

Параметры:

a — один массив для проверки на равенство

a2 — другой массив для проверки на равенство

Возвращает:

true, если два массива равны

См. также:

• Float.equals(Object)

public static boolean equals(float[] a, int aFromIndex, int aToIndex, float[] b, int bFromIndex, int bToIndex)

    Float.valueOf(f1).equals(Float.valueOf(f2))

Параметры:

a — первый массив для проверки на равенство

aFromIndex — индекс (включительно) первого проверяемого элемента в первом массиве

aToIndex — индекс (не включительно) последнего проверяемого элемента в первом массиве

b — второй массив для проверки на равенство

bFromIndex — индекс (включительно) первого проверяемого элемента во втором массиве

bToIndex — индекс (не включительно) последнего проверяемого элемента во втором массиве

Возвращает:

true, если два массива равны в указанных диапазонах

Исключения:

IllegalArgumentException — если aFromIndex > aToIndex или если bFromIndex > bToIndex

ArrayIndexOutOfBoundsException — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если один из массивов null

Начиная с версии:

9

См. также:

• Float.equals(Object)

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

Параметры:

a — один массив для проверки на равенство

a2 — другой массив для проверки на равенство

Возвращает:

true, если два массива равны

public static boolean equals(Object[] a, int aFromIndex, int aToIndex, Object[] b, int bFromIndex, int bToIndex)

Параметры:

a — первый массив для проверки на равенство

aFromIndex — индекс (включительно) первого проверяемого элемента в первом массиве

aToIndex — индекс (не включительно) последнего проверяемого элемента в первом массиве

b — второй массив для проверки на равенство

bFromIndex — индекс (включительно) первого проверяемого элемента во втором массиве

bToIndex — индекс (не включительно) последнего проверяемого элемента во втором массиве

Возвращает:

true, если два массива равны в указанных диапазонах

Исключения:

IllegalArgumentException — если aFromIndex > aToIndex или если bFromIndex > bToIndex

ArrayIndexOutOfBoundsException — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если один из массивов null

Начиная с версии:

9

public static <T> boolean equals(T[] a, T[] a2, Comparator<? super T> cmp)

Параметры типа:

T — тип элементов массива

Параметры:

a — один массив для проверки на равенство

a2 — другой массив для проверки на равенство

cmp — компаратор для сравнения элементов массива

Возвращает:

true, если два массива равны

Исключения:

NullPointerException — если компаратор null

Начиная с версии:

9

public static <T> boolean equals(T[] a, int aFromIndex, int aToIndex, T[] b, int bFromIndex, int bToIndex, Comparator<? super T> cmp)

Параметры типа:

T — тип элементов массива

Параметры:

a — первый массив для проверки на равенство

aFromIndex — индекс (включительно) первого проверяемого элемента в первом массиве

aToIndex — индекс (не включительно) последнего проверяемого элемента в первом массиве

b — второй массив для проверки на равенство

bFromIndex — индекс (включительно) первого проверяемого элемента во втором массиве

bToIndex — индекс (не включительно) последнего проверяемого элемента во втором массиве

cmp — компаратор для сравнения элементов массива

Возвращает:

true, если два массива равны в указанных диапазонах

Исключения:

IllegalArgumentException — если aFromIndex > aToIndex или если bFromIndex > bToIndex

ArrayIndexOutOfBoundsException — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если один из массивов или компаратор null

Начиная с версии:

9

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

Параметры:

a — массив для заполнения

val — значение, которое будет сохранено во всех элементах массива

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

Параметры:

a — массив для заполнения

fromIndex — индекс первого элемента (включительно), который будет заполнен указанным значением

toIndex — индекс последнего элемента (не включительно), который будет заполнен указанным значением

val — значение, которое будет сохранено во всех элементах массива

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

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

Параметры:

a — массив для заполнения

val — значение, которое будет сохранено во всех элементах массива

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

Параметры:

a — массив для заполнения

fromIndex — индекс первого элемента (включительно), который будет заполнен указанным значением

toIndex — индекс последнего элемента (не включительно), который будет заполнен указанным значением

val — значение, которое будет сохранено во всех элементах массива

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

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

Параметры:

a — массив для заполнения

val — значение, которое будет сохранено во всех элементах массива

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

Параметры:

a — массив для заполнения

fromIndex — индекс первого элемента (включительно), который будет заполнен указанным значением

toIndex — индекс последнего элемента (не включительно), который будет заполнен указанным значением

val — значение, которое будет сохранено во всех элементах массива

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

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

Параметры:

a — массив, который необходимо заполнить

val — значение, которое будет сохранено во всех элементах массива

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

Параметры:

a — массив, который необходимо заполнить

fromIndex — индекс первого элемента (включительно), который необходимо заполнить указанным значением

toIndex — индекс последнего элемента (исключительно), который необходимо заполнить указанным значением

val — значение, которое будет сохранено во всех элементах массива

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

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

Параметры:

a — массив, который необходимо заполнить

val — значение, которое будет сохранено во всех элементах массива

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

Параметры:

a — массив, который необходимо заполнить

fromIndex — индекс первого элемента (включительно), который необходимо заполнить указанным значением

toIndex — индекс последнего элемента (исключительно), который необходимо заполнить указанным значением

val — значение, которое будет сохранено во всех элементах массива

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

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

Параметры:

a — массив, который необходимо заполнить

val — значение, которое будет сохранено во всех элементах массива

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

Параметры:

a — массив, который необходимо заполнить

fromIndex — индекс первого элемента (включительно), который необходимо заполнить указанным значением

toIndex — индекс последнего элемента (исключительно), который необходимо заполнить указанным значением

val — значение, которое будет сохранено во всех элементах массива

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

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

Параметры:

a — массив, который необходимо заполнить

val — значение, которое будет сохранено во всех элементах массива

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

Параметры:

a — массив, который необходимо заполнить

fromIndex — индекс первого элемента (включительно), который необходимо заполнить указанным значением

toIndex — индекс последнего элемента (исключительно), который необходимо заполнить указанным значением

val — значение, которое будет сохранено во всех элементах массива

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

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

Параметры:

a — массив, который необходимо заполнить

val — значение, которое будет сохранено во всех элементах массива

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

Параметры:

a — массив, который необходимо заполнить

fromIndex — индекс первого элемента (включительно), который необходимо заполнить указанным значением

toIndex — индекс последнего элемента (исключительно), который необходимо заполнить указанным значением

val — значение, которое будет сохранено во всех элементах массива

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

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

Параметры:

a — массив, который необходимо заполнить

val — значение, которое будет сохранено во всех элементах массива

Исключения:

ArrayStoreException — если указанный объект не относится к типу времени выполнения, который можно сохранить в указанном массиве

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

Параметры:

a — массив, который необходимо заполнить

fromIndex — индекс первого элемента (включительно), который необходимо заполнить указанным значением

toIndex — индекс последнего элемента (исключительно), который необходимо заполнить указанным значением

val — значение, которое будет сохранено во всех элементах массива

Исключения:

IllegalArgumentException — если fromIndex > toIndex

ArrayIndexOutOfBoundsException — если fromIndex < 0 или toIndex > a.length

ArrayStoreException — если указанный объект не относится к типу времени выполнения, который можно сохранить в указанном массиве

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

Параметры типа:

T — класс объектов в массиве

Параметры:

original — массив, который необходимо скопировать

newLength — длина возвращаемой копии

Возвращает:

копию исходного массива, усечённую или дополненную значениями null до указанной длины

Исключения:

NegativeArraySizeException — если newLength отрицательно

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры типа:

T — класс объектов в возвращаемом массиве

U — класс объектов в исходном массиве

Параметры:

original — массив, который необходимо скопировать

newLength — длина возвращаемой копии

newType — класс возвращаемой копии

Возвращает:

копию исходного массива, усечённую или дополненную значениями null до указанной длины

Исключения:

NegativeArraySizeException — если newLength отрицательно

NullPointerException — если original равно null

ArrayStoreException — если элемент, скопированный из original, не относится к типу времени выполнения, который можно сохранить в массиве класса newType

Начиная с версии:

1.6

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

Параметры:

original — массив, который необходимо скопировать

newLength — длина возвращаемой копии

Возвращает:

копию исходного массива, усечённую или дополненную нулями до указанной длины

Исключения:

NegativeArraySizeException — если newLength отрицательно

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры:

original — массив, который необходимо скопировать

newLength — длина возвращаемой копии

Возвращает:

копию исходного массива, усечённую или дополненную нулями до указанной длины

Исключения:

NegativeArraySizeException — если newLength отрицательно

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры:

original — массив, который необходимо скопировать

newLength — длина возвращаемой копии

Возвращает:

копию исходного массива, усечённую или дополненную нулями до указанной длины

Исключения:

NegativeArraySizeException — если newLength отрицательно

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры:

original — массив, который необходимо скопировать

newLength — длина возвращаемой копии

Возвращает:

копию исходного массива, усечённую или дополненную нулями до указанной длины

Исключения:

NegativeArraySizeException — если newLength отрицательно

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры:

original — массив, который необходимо скопировать

newLength — длина возвращаемой копии

Возвращает:

копию исходного массива, усечённую или дополненную нулевыми символами до указанной длины

Исключения:

NegativeArraySizeException — если newLength отрицательно

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры:

original — массив, который необходимо скопировать

newLength — длина возвращаемой копии

Возвращает:

копию исходного массива, усечённую или дополненную нулями до указанной длины

Исключения:

NegativeArraySizeException — если newLength отрицательно

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры:

original — массив, который необходимо скопировать

newLength — длина возвращаемой копии

Возвращает:

копию исходного массива, усечённую или дополненную нулями до указанной длины

Исключения:

NegativeArraySizeException — если newLength отрицательно

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры:

original — массив, который необходимо скопировать

newLength — длина возвращаемой копии

Возвращает:

копию исходного массива, усечённую или дополненную элементами со значением false до указанной длины

Исключения:

NegativeArraySizeException — если newLength отрицательно

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры типа:

T — класс объектов в массиве

Параметры:

original — массив, из которого копируется диапазон

from — начальный индекс копируемого диапазона включительно

to — конечный индекс копируемого диапазона исключительно. (Этот индекс может находиться за пределами массива.)

Возвращает:

новый массив, содержащий указанный диапазон исходного массива, усечённый или дополненный значениями null до требуемой длины

Исключения:

ArrayIndexOutOfBoundsException — если from < 0 или from > original.length

IllegalArgumentException — если from > to

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры типа:

T — класс объектов в возвращаемом массиве

U — класс объектов в исходном массиве

Параметры:

original — массив, из которого копируется диапазон

from — начальный индекс копируемого диапазона включительно

to — конечный индекс копируемого диапазона исключительно. (Этот индекс может находиться за пределами массива.)

newType — класс возвращаемой копии

Возвращает:

новый массив, содержащий указанный диапазон исходного массива, усечённый или дополненный значениями null до требуемой длины

Исключения:

ArrayIndexOutOfBoundsException — если from < 0 или from > original.length

IllegalArgumentException — если from > to

NullPointerException — если original равно null

ArrayStoreException — если элемент, скопированный из original, не относится к типу времени выполнения, который можно сохранить в массиве класса newType.

Начиная с версии:

1.6

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

Параметры:

original — массив, из которого копируется диапазон

from — начальный индекс копируемого диапазона включительно

to — конечный индекс копируемого диапазона исключительно. (Этот индекс может находиться за пределами массива.)

Возвращает:

новый массив, содержащий указанный диапазон исходного массива, усечённый или дополненный нулями до требуемой длины

Исключения:

ArrayIndexOutOfBoundsException — если from < 0 или from > original.length

IllegalArgumentException — если from > to

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры:

original — массив, из которого копируется диапазон

from — начальный индекс копируемого диапазона включительно

to — конечный индекс копируемого диапазона исключительно. (Этот индекс может находиться за пределами массива.)

Возвращает:

новый массив, содержащий указанный диапазон исходного массива, усечённый или дополненный нулями до требуемой длины

Исключения:

ArrayIndexOutOfBoundsException — если from < 0 или from > original.length

IllegalArgumentException — если from > to

NullPointerException — если original равно null

Начиная с версии:

1.6

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

Параметры:

original - массив, из которого копируется диапазон

from - начальный индекс копируемого диапазона включительно

to - конечный индекс копируемого диапазона, не включительно. (Этот индекс может находиться за пределами массива.)

Возвращает:

новый массив, содержащий указанный диапазон исходного массива, усечённый или дополненный нулями для получения требуемой длины

Исключения:

ArrayIndexOutOfBoundsException - если from < 0 или from > original.length

IllegalArgumentException - если from > to

NullPointerException - если original равен null

С версии:

1.6

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

Параметры:

original - массив, из которого копируется диапазон

from - начальный индекс копируемого диапазона включительно

to - конечный индекс копируемого диапазона, не включительно. (Этот индекс может находиться за пределами массива.)

Возвращает:

новый массив, содержащий указанный диапазон исходного массива, усечённый или дополненный нулями для получения требуемой длины

Исключения:

ArrayIndexOutOfBoundsException - если from < 0 или from > original.length

IllegalArgumentException - если from > to

NullPointerException - если original равен null

С версии:

1.6

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

Параметры:

original - массив, из которого копируется диапазон

from - начальный индекс копируемого диапазона включительно

to - конечный индекс копируемого диапазона, не включительно. (Этот индекс может находиться за пределами массива.)

Возвращает:

новый массив, содержащий указанный диапазон исходного массива, усечённый или дополненный нулевыми символами для получения требуемой длины

Исключения:

ArrayIndexOutOfBoundsException - если from < 0 или from > original.length

IllegalArgumentException - если from > to

NullPointerException - если original равен null

С версии:

1.6

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

Параметры:

original - массив, из которого копируется диапазон

from - начальный индекс копируемого диапазона включительно

to - конечный индекс копируемого диапазона, не включительно. (Этот индекс может находиться за пределами массива.)

Возвращает:

новый массив, содержащий указанный диапазон исходного массива, усечённый или дополненный нулями для получения требуемой длины

Исключения:

ArrayIndexOutOfBoundsException - если from < 0 или from > original.length

IllegalArgumentException - если from > to

NullPointerException - если original равен null

С версии:

1.6

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

Параметры:

original - массив, из которого копируется диапазон

from - начальный индекс копируемого диапазона включительно

to - конечный индекс копируемого диапазона, не включительно. (Этот индекс может находиться за пределами массива.)

Возвращает:

новый массив, содержащий указанный диапазон исходного массива, усечённый или дополненный нулями для получения требуемой длины

Исключения:

ArrayIndexOutOfBoundsException - если from < 0 или from > original.length

IllegalArgumentException - если from > to

NullPointerException - если original равен null

С версии:

1.6

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

Параметры:

original - массив, из которого копируется диапазон

from - начальный индекс копируемого диапазона включительно

to - конечный индекс копируемого диапазона, не включительно. (Этот индекс может находиться за пределами массива.)

Возвращает:

новый массив, содержащий указанный диапазон исходного массива, усечённый или дополненный элементами false для получения требуемой длины

Исключения:

ArrayIndexOutOfBoundsException - если from < 0 или from > original.length

IllegalArgumentException - если from > to

NullPointerException - если original равен null

С версии:

1.6

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

Примечание API:

Этот метод служит связующим звеном между API на основе массивов и API на основе коллекций в сочетании с Collection.toArray().

Этот метод позволяет обернуть существующий массив:

    Integer[] numbers = ...
    ...
    List<Integer> values = Arrays.asList(numbers);

Этот метод также предоставляет удобный способ создать список фиксированного размера, изначально содержащий несколько элементов:

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

Список, возвращаемый этим методом, можно изменять. Чтобы создать неизменяемый список, используйте Collections.unmodifiableList или неизменяемые списки.

Параметры типа:

T - класс объектов в массиве

Параметры:

a - массив, на котором будет основан список

Возвращает:

представление указанного массива в виде списка

Исключения:

NullPointerException - если указанный массив равен null

public static int hashCode(long[] a)

Параметры:

a - массив, хеш-значение которого нужно вычислить

Возвращает:

хеш-код a, основанный на содержимом

С версии:

1.5

public static int hashCode(int[] a)

Параметры:

a - массив, хеш-значение которого нужно вычислить

Возвращает:

хеш-код a, основанный на содержимом

С версии:

1.5

public static int hashCode(short[] a)

Параметры:

a - массив, хеш-значение которого нужно вычислить

Возвращает:

хеш-код a, основанный на содержимом

С версии:

1.5

public static int hashCode(char[] a)

Параметры:

a - массив, хеш-значение которого нужно вычислить

Возвращает:

хеш-код a, основанный на содержимом

С версии:

1.5

public static int hashCode(byte[] a)

Параметры:

a - массив, хеш-значение которого нужно вычислить

Возвращает:

хеш-код a, основанный на содержимом

С версии:

1.5

public static int hashCode(boolean[] a)

Параметры:

a - массив, хеш-значение которого нужно вычислить

Возвращает:

хеш-код a, основанный на содержимом

С версии:

1.5

public static int hashCode(float[] a)

Параметры:

a - массив, хеш-значение которого нужно вычислить

Возвращает:

хеш-код a, основанный на содержимом

С версии:

1.5

public static int hashCode(double[] a)

Параметры:

a - массив, хеш-значение которого нужно вычислить

Возвращает:

хеш-код a, основанный на содержимом

С версии:

1.5

public static int hashCode(Object[] a)

Параметры:

a - массив, для которого нужно вычислить хеш-код на основе содержимого

Возвращает:

хеш-код a, основанный на содержимом

С версии:

1.5

См. также:

• deepHashCode(Object[])

public static int deepHashCode(Object[] a)

Параметры:

a - массив, для которого нужно вычислить хеш-код на основе глубокого содержимого

Возвращает:

хеш-код a, основанный на глубоком содержимом

С версии:

1.5

См. также:

• hashCode(Object[])

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

Параметры:

a1 - один из массивов для проверки на равенство

a2 - другой массив для проверки на равенство

Возвращает:

true, если два массива равны

С версии:

1.5

См. также:

• equals(Object[],Object[])
• Objects.deepEquals(Object, Object)

public static String toString(long[] a)

Параметры:

a - массив, строковое представление которого нужно вернуть

Возвращает:

строковое представление a

С версии:

1.5

public static String toString(int[] a)

Параметры:

a - массив, строковое представление которого нужно вернуть

Возвращает:

строковое представление a

С версии:

1.5

public static String toString(short[] a)

Параметры:

a - массив, строковое представление которого нужно вернуть

Возвращает:

строковое представление a

С версии:

1.5

public static String toString(char[] a)

Параметры:

a — массив, строковое представление которого нужно вернуть

Возвращает:

строковое представление a

С версии:

1.5

public static String toString(byte[] a)

Параметры:

a — массив, строковое представление которого нужно вернуть

Возвращает:

строковое представление a

С версии:

1.5

public static String toString(boolean[] a)

Параметры:

a — массив, строковое представление которого нужно вернуть

Возвращает:

строковое представление a

С версии:

1.5

public static String toString(float[] a)

Параметры:

a — массив, строковое представление которого нужно вернуть

Возвращает:

строковое представление a

С версии:

1.5

public static String toString(double[] a)

Параметры:

a — массив, строковое представление которого нужно вернуть

Возвращает:

строковое представление a

С версии:

1.5

public static String toString(Object[] a)

Параметры:

a — массив, строковое представление которого нужно вернуть

Возвращает:

строковое представление a

С версии:

1.5

См. также:

• deepToString(Object[])

public static String deepToString(Object[] a)

Параметры:

a — массив, строковое представление которого нужно вернуть

Возвращает:

строковое представление a

С версии:

1.5

См. также:

• toString(Object[])

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

Примечание API:

Установку элементов поддиапазона массива с помощью функции-генератора, вычисляющей каждый элемент, можно записать следующим образом:

IntStream.range(startInclusive, endExclusive)
         .forEach(i -> array[i] = generator.apply(i));

Параметры типа:

T — тип элементов массива

Параметры:

array — массив, который нужно инициализировать

generator — функция, принимающая индекс и возвращающая требуемое значение для этой позиции

Исключения:

NullPointerException — если генератор равен null

С версии:

1.8

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

Примечание API:

Параллельную установку элементов поддиапазона массива с помощью функции-генератора, вычисляющей каждый элемент, можно записать следующим образом:

IntStream.range(startInclusive, endExclusive)
         .parallel()
         .forEach(i -> array[i] = generator.apply(i));

Параметры типа:

T — тип элементов массива

Параметры:

array — массив, который нужно инициализировать

generator — функция, принимающая индекс и возвращающая требуемое значение для этой позиции

Исключения:

NullPointerException — если генератор равен null

С версии:

1.8

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

Примечание API:

Установку элементов поддиапазона массива с помощью функции-генератора, вычисляющей каждый элемент, можно записать следующим образом:

IntStream.range(startInclusive, endExclusive)
         .forEach(i -> array[i] = generator.applyAsInt(i));

Параметры:

array — массив, который нужно инициализировать

generator — функция, принимающая индекс и возвращающая требуемое значение для этой позиции

Исключения:

NullPointerException — если генератор равен null

С версии:

1.8

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

Примечание API:

Параллельную установку элементов поддиапазона массива с помощью функции-генератора, вычисляющей каждый элемент, можно записать следующим образом:

IntStream.range(startInclusive, endExclusive)
         .parallel()
         .forEach(i -> array[i] = generator.applyAsInt(i));

Параметры:

array — массив, который нужно инициализировать

generator — функция, принимающая индекс и возвращающая требуемое значение для этой позиции

Исключения:

NullPointerException — если генератор равен null

С версии:

1.8

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

Примечание API:

Установку элементов поддиапазона массива с помощью функции-генератора, вычисляющей каждый элемент, можно записать следующим образом:

IntStream.range(startInclusive, endExclusive)
         .forEach(i -> array[i] = generator.applyAsLong(i));

Параметры:

array — массив, который нужно инициализировать

generator — функция, принимающая индекс и возвращающая требуемое значение для этой позиции

Исключения:

NullPointerException — если генератор равен null

С версии:

1.8

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

Примечание API:

Параллельную установку элементов поддиапазона массива с помощью функции-генератора, вычисляющей каждый элемент, можно записать следующим образом:

IntStream.range(startInclusive, endExclusive)
         .parallel()
         .forEach(i -> array[i] = generator.applyAsLong(i));

Параметры:

array — массив, который нужно инициализировать

generator — функция, принимающая индекс и возвращающая требуемое значение для этой позиции

Исключения:

NullPointerException — если генератор равен null

С версии:

1.8

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

Примечание API:

Установку элементов поддиапазона массива с помощью функции-генератора, вычисляющей каждый элемент, можно записать следующим образом:

IntStream.range(startInclusive, endExclusive)
         .forEach(i -> array[i] = generator.applyAsDouble(i));

Параметры:

array — массив, который нужно инициализировать

generator — функция, принимающая индекс и возвращающая требуемое значение для этой позиции

Исключения:

NullPointerException — если генератор равен null

С версии:

1.8

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

Примечание API:

Параллельную установку элементов поддиапазона массива с помощью функции-генератора, вычисляющей каждый элемент, можно записать следующим образом:

IntStream.range(startInclusive, endExclusive)
         .parallel()
         .forEach(i -> array[i] = generator.applyAsDouble(i));

Параметры:

array — массив, который нужно инициализировать

generator — функция, принимающая индекс и возвращающая требуемое значение для этой позиции

Исключения:

NullPointerException — если генератор равен null

С версии:

1.8

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

Параметры типа:

T — тип элементов

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

Возвращает:

сплитератор для элементов массива

С версии:

1.8

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

Параметры типа:

T — тип элементов

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

startInclusive — первый охватываемый индекс включительно

endExclusive — индекс, следующий непосредственно за последним охватываемым индексом

Возвращает:

сплитератор для элементов массива

Исключения:

ArrayIndexOutOfBoundsException — если startInclusive отрицателен, endExclusive меньше startInclusive или endExclusive больше размера массива

С версии:

1.8

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

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

Возвращает:

сплитератор для элементов массива

С версии:

1.8

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

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

startInclusive — первый охватываемый индекс включительно

endExclusive — индекс, следующий непосредственно за последним охватываемым индексом

Возвращает:

сплитератор для элементов массива

Исключения:

ArrayIndexOutOfBoundsException — если startInclusive отрицателен, endExclusive меньше startInclusive или endExclusive больше размера массива

С версии:

1.8

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

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

Возвращает:

сплитератор для элементов массива

С версии:

1.8

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

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

startInclusive — первый охватываемый индекс включительно

endExclusive — индекс, следующий непосредственно за последним охватываемым индексом

Возвращает:

сплитератор для элементов массива

Исключения:

ArrayIndexOutOfBoundsException — если startInclusive отрицателен, endExclusive меньше startInclusive или endExclusive больше размера массива

С версии:

1.8

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

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

Возвращает:

сплитератор для элементов массива

С версии:

1.8

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

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

startInclusive — первый охватываемый индекс включительно

endExclusive — индекс, следующий непосредственно за последним охватываемым индексом

Возвращает:

сплитератор для элементов массива

Исключения:

ArrayIndexOutOfBoundsException — если startInclusive отрицателен, endExclusive меньше startInclusive или endExclusive больше размера массива

С версии:

1.8

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

Параметры типа:

T — тип элементов массива

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

Возвращает:

Stream для массива

С версии:

1.8

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

Параметры типа:

T — тип элементов массива

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

startInclusive — первый охватываемый индекс включительно

endExclusive — индекс, следующий непосредственно за последним охватываемым индексом

Возвращает:

Stream для диапазона массива

Исключения:

ArrayIndexOutOfBoundsException — если startInclusive отрицателен, endExclusive меньше startInclusive или endExclusive больше размера массива

С версии:

1.8

public static IntStream stream(int[] array)

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

Возвращает:

IntStream для массива

С версии:

1.8

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

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

startInclusive — первый охватываемый индекс включительно

endExclusive — индекс, следующий непосредственно за последним охватываемым индексом

Возвращает:

IntStream для диапазона массива

Исключения:

ArrayIndexOutOfBoundsException — если startInclusive отрицателен, endExclusive меньше startInclusive или endExclusive больше размера массива

С версии:

1.8

public static LongStream stream(long[] array)

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

Возвращает:

LongStream для массива

С версии:

1.8

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

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

startInclusive — первый охватываемый индекс включительно

endExclusive — индекс, следующий непосредственно за последним охватываемым индексом

Возвращает:

LongStream для диапазона массива

Исключения:

ArrayIndexOutOfBoundsException — если startInclusive отрицателен, endExclusive меньше startInclusive или endExclusive больше размера массива

С версии:

1.8

public static DoubleStream stream(double[] array)

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

Возвращает:

DoubleStream для массива

С версии:

1.8

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

Параметры:

array — массив, который, как предполагается, не изменяется во время использования

startInclusive — первый охватываемый индекс включительно

endExclusive — индекс, следующий непосредственно за последним охватываемым индексом

Возвращает:

DoubleStream для диапазона массива

Исключения:

ArrayIndexOutOfBoundsException — если startInclusive отрицателен, endExclusive меньше startInclusive или endExclusive больше размера массива

С версии:

1.8

public static int compare(boolean[] a, boolean[] b)

    Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)

Примечание API:

Этот метод работает так, как если бы (для ссылок на массивы, не являющиеся 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;

Параметры:

a — первый сравниваемый массив

b — второй сравниваемый массив

Возвращает:

значение 0, если первый и второй массивы равны и содержат одинаковые элементы в одинаковом порядке; значение меньше 0, если первый массив лексикографически меньше второго; и значение больше 0, если первый массив лексикографически больше второго

С версии:

9

public static int compare(boolean[] a, int aFromIndex, int aToIndex, boolean[] b, int bFromIndex, int bToIndex)

    Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
        (Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)

Примечание API:

Этот метод работает так, как если бы:

    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

public static int compare(byte[] a, byte[] b)

    Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)

Примечание API:

Этот метод работает так, как если бы (для ссылок на массивы, не являющиеся 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

public static int compare(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex)

    Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
        (Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)

Примечание API:

Этот метод работает так, как если бы:

    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

public static int compareUnsigned(byte[] a, byte[] b)

Примечание API:

Этот метод работает так, как если бы (для ссылок на массивы, не являющиеся 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

public static int compareUnsigned(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex)

Примечание API:

Этот метод работает так, как если бы:

    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

public static int compare(short[] a, short[] b)

    Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)

Примечание API:

Этот метод работает так, как если бы (для ссылок на массивы, не являющиеся 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;

Параметры:

a — первый сравниваемый массив

b — второй сравниваемый массив

Возвращает:

значение 0, если первый и второй массивы равны и содержат одинаковые элементы в одинаковом порядке; значение меньше 0, если первый массив лексикографически меньше второго; и значение больше 0, если первый массив лексикографически больше второго

С версии:

9

public static int compare(short[] a, int aFromIndex, int aToIndex, short[] b, int bFromIndex, int bToIndex)

    Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
        (Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)

Примечание API:

Этот метод работает так, как если бы:

    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);

Параметры:

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 int compareUnsigned(short[] a, short[] b)

Примечание API:

Этот метод работает так, как если бы (для ссылок на массивы, не являющиеся 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;

Параметры:

a — первый сравниваемый массив

b — второй сравниваемый массив

Возвращает:

значение 0, если первый и второй массивы равны и содержат одинаковые элементы в одинаковом порядке; значение меньше 0, если первый массив лексикографически меньше второго; и значение больше 0, если первый массив лексикографически больше второго

С версии:

9

public static int compareUnsigned(short[] a, int aFromIndex, int aToIndex, short[] b, int bFromIndex, int bToIndex)

Примечание API:

Этот метод работает так, как если бы:

    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);

Параметры:

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 int compare(char[] a, char[] b)

    Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)

Примечание API:

Этот метод работает так, как если бы (для ссылок на массивы, не являющиеся 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;

Параметры:

a — первый сравниваемый массив

b — второй сравниваемый массив

Возвращает:

значение 0, если первый и второй массивы равны и содержат одинаковые элементы в одинаковом порядке; значение меньше 0, если первый массив лексикографически меньше второго; и значение больше 0, если первый массив лексикографически больше второго

С версии:

9

public static int compare(char[] a, int aFromIndex, int aToIndex, char[] b, int bFromIndex, int bToIndex)

    Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
        (Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)

Примечание API:

Этот метод работает так, как если бы:

    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

public static int compare(int[] a, int[] b)

    Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)

Примечание API:

Этот метод работает так, как если бы (для ссылок на массивы, не являющиеся 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

public static int compare(int[] a, int aFromIndex, int aToIndex, int[] b, int bFromIndex, int bToIndex)

    Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
        (Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)

Примечание об API:

Этот метод ведёт себя так, как если бы:

    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 — если aFromIndex < 0 or aToIndex > a.length или если bFromIndex < 0 or bToIndex > b.length

NullPointerException — если любой из массивов равен null

С версии:

9

public static int compareUnsigned(int[] a, int[] b)

Примечание об API:

Этот метод ведёт себя так, как если бы (для ссылок на массивы, не являющиеся 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

public static int compareUnsigned(int[] a, int aFromIndex, int aToIndex, int[] b, int bFromIndex, int bToIndex)

Примечание об API:

Этот метод ведёт себя так, как если бы:

    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

public static int compare(long[] a, long[] b)

    Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)

Примечание об API:

Этот метод ведёт себя так, как если бы (для ссылок на массивы, не являющиеся 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;

Параметры:

a — первый сравниваемый массив

b — второй сравниваемый массив

Возвращает:

значение 0, если первый и второй массивы равны и содержат одинаковые элементы в одинаковом порядке; значение меньше 0, если первый массив лексикографически меньше второго; и значение больше 0, если первый массив лексикографически больше второго

С версии:

9

public static int compare(long[] a, int aFromIndex, int aToIndex, long[] b, int bFromIndex, int bToIndex)

    Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
        (Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)

Примечание об API:

Этот метод ведёт себя так, как если бы:

    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);

Параметры:

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 int compareUnsigned(long[] a, long[] b)

Примечание об API:

Этот метод ведёт себя так, как если бы (для ссылок на массивы, не являющиеся 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;

Параметры:

a — первый сравниваемый массив

b — второй сравниваемый массив

Возвращает:

значение 0, если первый и второй массивы равны и содержат одинаковые элементы в одинаковом порядке; значение меньше 0, если первый массив лексикографически меньше второго; и значение больше 0, если первый массив лексикографически больше второго

С версии:

9

public static int compareUnsigned(long[] a, int aFromIndex, int aToIndex, long[] b, int bFromIndex, int bToIndex)

Примечание об API:

Этот метод ведёт себя так, как если бы:

    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);

Параметры:

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 int compare(float[] a, float[] b)

    Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)

Примечание об API:

Этот метод ведёт себя так, как если бы (для ссылок на массивы, не являющиеся 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;

Параметры:

a — первый сравниваемый массив

b — второй сравниваемый массив

Возвращает:

значение 0, если первый и второй массивы равны и содержат одинаковые элементы в одинаковом порядке; значение меньше 0, если первый массив лексикографически меньше второго; и значение больше 0, если первый массив лексикографически больше второго

С версии:

9

public static int compare(float[] a, int aFromIndex, int aToIndex, float[] b, int bFromIndex, int bToIndex)

    Arrays.equals(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) ==
        (Arrays.compare(a, aFromIndex, aToIndex, b, bFromIndex, bToIndex) == 0)

Примечание об API:

Этот метод ведёт себя так, как если бы:

    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