Класс Arrays

public static void sort(int[] a)

Описание реализации:

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

Параметры:

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

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

Описание реализации:

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

public static void sort(long[] a)

Описание реализации:

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

Параметры:

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

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

Описание реализации:

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

public static void sort(short[] a)

Описание реализации:

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

Параметры:

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

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

Описание реализации:

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

public static void sort(char[] a)

Описание реализации:

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

Параметры:

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

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

Описание реализации:

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

public static void sort(byte[] a)

Описание реализации:

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

Параметры:

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

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

Описание реализации:

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

public static void sort(float[] a)

Описание реализации:

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

Параметры:

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

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

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

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

Параметры:

a - массив, который нужно отсортировать

fromIndex - индекс первого элемента, включительно, который нужно отсортировать

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

public static void sort(double[] a)

Отношение < не обеспечивает полной упорядоченности для всех значений double: -0.0d == 0.0d является true, а значение Double.NaN не сравнивается ни меньше, ни больше, ни равно любому значению, даже самому себе. Этот метод использует полное упорядочение, заданное методом Double.compareTo(java.lang.Double): значение -0.0d считается меньше значения 0.0d, а Double.NaN считается больше любого другого значения, и все значения Double.NaN считаются равными.

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

При реализации:

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

Параметры:

a - массив, который нужно отсортировать

fromIndex - индекс первого элемента, включительно, который нужно отсортировать

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

public static void parallelSort(byte[] a)

При реализации:

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

Параметры:

a - массив, который нужно отсортировать

С тех пор:

1.8

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

При реализации:

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

Параметры:

a - массив, который нужно отсортировать

fromIndex - индекс первого элемента, включительно, который нужно отсортировать

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С тех пор:

1.8

public static void parallelSort(char[] a)

При реализации:

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

Параметры:

a - массив, который нужно отсортировать

С тех пор:

1.8

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

При реализации:

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

Параметры:

a - массив, который нужно отсортировать

fromIndex - индекс первого элемента, включительно, который нужно отсортировать

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С тех пор:

1.8

public static void parallelSort(short[] a)

При реализации:

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

Параметры:

a - массив, который нужно отсортировать

С тех пор:

1.8

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

При реализации:

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

Параметры:

a - массив, который нужно отсортировать

fromIndex - индекс первого элемента, включительно, который нужно отсортировать

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С тех пор:

1.8

public static void parallelSort(int[] a)

При реализации:

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

Параметры:

a - массив, который нужно отсортировать

С тех пор:

1.8

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

Описание реализации:

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

Параметры:

a - массив, подлежащий сортировке

fromIndex - индекс первого элемента (включительно), подлежащего сортировке

toIndex - индекс последнего элемента (исключительно), подлежащего сортировке

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С момента:

1.8

public static void parallelSort(long[] a)

Описание реализации:

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

Параметры:

a - массив, подлежащий сортировке

С момента:

1.8

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

Описание реализации:

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

Параметры:

a - массив, подлежащий сортировке

fromIndex - индекс первого элемента (включительно), подлежащего сортировке

toIndex - индекс последнего элемента (исключительно), подлежащего сортировке

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С момента:

1.8

public static void parallelSort(float[] a)

Описание реализации:

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

Параметры:

a - массив, подлежащий сортировке

С момента:

1.8

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

Описание реализации:

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

Параметры:

a - массив, подлежащий сортировке

fromIndex - индекс первого элемента (включительно), подлежащего сортировке

toIndex - индекс последнего элемента (исключительно), подлежащего сортировке

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С момента:

1.8

public static void parallelSort(double[] a)

Описание реализации:

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

Параметры:

a - массив, подлежащий сортировке

С момента:

1.8

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

Описание реализации:

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

Параметры:

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)

Parameters:

a - the array to be sorted

fromIndex - the index of the first element (inclusive) to be sorted

toIndex - the index of the last element (exclusive) to be sorted

Throws:

IllegalArgumentException - if fromIndex > toIndex or (optional) если естественный порядок элементов массива нарушает контракт Comparable

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

ClassCastException - if the array contains elements that are not mutually comparable (for example, strings and integers).

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

Type Parameters:

T - тип объектов, которые нужно отсортировать

Parameters:

a - the array to be sorted

c - the comparator to determine the order of the array. A null value indicates that the elements' natural ordering should be used.

Throws:

ClassCastException - if the array contains elements that are not mutually comparable using the specified comparator

IllegalArgumentException - (optional) если компаратор нарушает контракт Comparator

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

Type Parameters:

T - тип объектов, которые нужно отсортировать

Parameters:

a - the array to be sorted

fromIndex - the index of the first element (inclusive) to be sorted

toIndex - the index of the last element (exclusive) to be sorted

c - the comparator to determine the order of the array. A null value indicates that the elements' natural ordering should be used.

Throws:

ClassCastException - if the array contains elements that are not mutually comparable using the specified comparator.

IllegalArgumentException - if fromIndex > toIndex or (optional) если компаратор нарушает контракт Comparator

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

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

Type Parameters:

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

Parameters:

array - the array, which is modified in-place by this method

op - a side-effect-free, associative function to perform the cumulation

Throws:

NullPointerException - if the specified array or function is null

Since:

1.8

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

Type Parameters:

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

Parameters:

array - the array

fromIndex - the index of the first element, inclusive

toIndex - the index of the last element, exclusive

op - a side-effect-free, associative function to perform the cumulation

Throws:

IllegalArgumentException - if fromIndex > toIndex

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > array.length

NullPointerException - if the specified array or function is null

Since:

1.8

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

Parameters:

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

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

Throws:

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

Since:

1.8

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

Parameters:

array - массив

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

toIndex - индекс последнего элемента, исключая его

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

Throws:

IllegalArgumentException - если fromIndex > toIndex

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

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

Since:

1.8

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

Parameters:

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

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

Throws:

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

Since:

1.8

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

Parameters:

array - массив

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

toIndex - индекс последнего элемента, исключая его

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

Throws:

IllegalArgumentException - если fromIndex > toIndex

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

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

Since:

1.8

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

Parameters:

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

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

Throws:

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

Since:

1.8

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

Parameters:

array - массив

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

toIndex - индекс последнего элемента, исключая его

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

Throws:

IllegalArgumentException - если fromIndex > toIndex

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

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

Since:

1.8

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

Parameters:

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

key - значение для поиска

Returns:

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

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

Parameters:

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

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

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

key - значение для поиска

Returns:

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

Throws:

IllegalArgumentException - если fromIndex > toIndex

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

Since:

1.6

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

Parameters:

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

key - значение для поиска

Returns:

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

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

Parameters:

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

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

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

key - значение для поиска

Returns:

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

Throws:

IllegalArgumentException - если fromIndex > toIndex

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

Since:

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, если все элементы массива меньше указанного ключа.

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

Параметры:

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

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

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

key - значение для поиска

Возвращает:

индекс ключа поиска, если он содержится в массиве в указанном диапазоне; в противном случае, (-(insertion point) - 1). Точка вставки определяется как точка, в которой ключ был бы вставлен в массив: индекс первого элемента в диапазоне, большего ключа, или toIndex, если все элементы в диапазоне меньше указанного ключа.

Исключения:

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)

Parameters:

a - первый массив, проверяемый на равенство

aFromIndex - индекс (включительно) первого элемента в первом массиве, подлежащего проверке

aToIndex - индекс (исключительно) последнего элемента в первом массиве, подлежащего проверке

b - второй массив, проверяемый на равенство

bFromIndex - индекс (включительно) первого элемента во втором массиве, подлежащего проверке

bToIndex - индекс (исключительно) последнего элемента во втором массиве, подлежащего проверке

Returns:

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

Throws:

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

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

NullPointerException - если любой из массивов является null

Since:

9

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

Parameters:

a - один массив, проверяемый на равенство

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

Returns:

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

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

Parameters:

a - первый массив, проверяемый на равенство

aFromIndex - индекс (включительно) первого элемента в первом массиве, подлежащего проверке

aToIndex - индекс (исключительно) последнего элемента в первом массиве, подлежащего проверке

b - второй массив, проверяемый на равенство

bFromIndex - индекс (включительно) первого элемента во втором массиве, подлежащего проверке

bToIndex - индекс (исключительно) последнего элемента во втором массиве, подлежащего проверке

Returns:

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

Throws:

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

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

NullPointerException - если любой из массивов является null

Since:

9

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

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

Parameters:

a - один массив, проверяемый на равенство

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

Returns:

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

See Also:

• 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))

Parameters:

a - первый массив, проверяемый на равенство

aFromIndex - индекс (включительно) первого элемента в первом массиве, подлежащего проверке

aToIndex - индекс (исключительно) последнего элемента в первом массиве, подлежащего проверке

b - второй массив, проверяемый на равенство

bFromIndex - индекс (включительно) первого элемента во втором массиве, подлежащего проверке

bToIndex - индекс (исключительно) последнего элемента во втором массиве, подлежащего проверке

Returns:

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

Throws:

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

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

NullPointerException - если любой из массивов является null

Since:

9

See Also:

• Double.equals(Object)

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

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

Parameters:

a - один массив, проверяемый на равенство

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

Returns:

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

See Also:

• 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))

Parameters:

a - первый массив, проверяемый на равенство

aFromIndex - индекс (включительно) первого элемента в первом массиве, подлежащего проверке

aToIndex - индекс (исключительно) последнего элемента в первом массиве, подлежащего проверке

b - второй массив, проверяемый на равенство

bFromIndex - индекс (включительно) первого элемента во втором массиве, подлежащего проверке

bToIndex - индекс (исключительно) последнего элемента во втором массиве, подлежащего проверке

Returns:

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

Throws:

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

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

NullPointerException - если любой из массивов является null

Since:

9

See Also:

• Float.equals(Object)

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

Parameters:

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

a2 - другой массив, который будет проверяться на равенство

Returns:

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

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

Parameters:

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

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

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

b - второй массив, который будет проверяться на равенство

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

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

Returns:

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

Throws:

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

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

NullPointerException - если любой массив является null

Since:

9

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

Type Parameters:

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

Parameters:

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

a2 - другой массив, который будет проверяться на равенство

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

Returns:

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

Throws:

NullPointerException - если компаратор является null

Since:

9

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

Type Parameters:

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

Parameters:

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

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

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

b - второй массив, который будет проверяться на равенство

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

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

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

Returns:

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

Throws:

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

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

NullPointerException - если любой массив или компаратор является null

Since:

9

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

Parameters:

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

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

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

Parameters:

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

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

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

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

Throws:

IllegalArgumentException - если fromIndex > toIndex

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

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

Parameters:

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

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

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

Parameters:

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

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

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

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

Throws:

IllegalArgumentException - если fromIndex > toIndex

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

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

Parameters:

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

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

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

Parameters:

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

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

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

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

Throws:

IllegalArgumentException - если fromIndex > toIndex

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

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

Parameters:

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)

Type Parameters:

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

Параметры:

original - массив, который нужно скопировать

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

Возвращает:

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

Исключение:

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 - класс возвращаемой копии

Возвращает:

копию исходного массива, обрезанную или дополненную нулями, чтобы получить заданную длину

Исключения:

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)

Type Parameters:

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

Parameters:

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

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если from > to

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

Since:

1.6

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

Type Parameters:

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

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

Parameters:

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

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

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если from > to

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

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

Since:

1.6

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

Parameters:

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

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если from > to

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

Since:

1.6

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

Parameters:

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

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если from > to

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

Since:

1.6

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

Parameters:

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

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если from > to

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

Since:

1.6

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

Parameters:

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

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если from > to

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

Since:

1.6

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

Parameters:

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

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если from > to

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

Since:

1.6

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

Parameters:

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

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если from > to

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

Since:

1.6

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

Parameters:

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

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если from > to

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

Since:

1.6

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

Parameters:

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

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если from > to

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

Since:

1.6

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

API Note:

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

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

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

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

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

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

Type Parameters:

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

Parameters:

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

Returns:

вид списка указанного массива

Throws:

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

public static int hashCode(long[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static int hashCode(int[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static int hashCode(short[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static int hashCode(char[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static int hashCode(byte[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static int hashCode(boolean[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static int hashCode(float[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static int hashCode(double[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static int hashCode(Object[] a)

Parameters:

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

Returns:

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

Since:

1.5

See Also:

• deepHashCode(Object[])

public static int deepHashCode(Object[] a)

Parameters:

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

Returns:

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

Since:

1.5

See Also:

• hashCode(Object[])

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

Parameters:

a1 - один массив, который нужно проверить на равенство

a2 - другой массив, который нужно проверить на равенство

Returns:

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

Since:

1.5

See Also:

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

public static String toString(long[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static String toString(int[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static String toString(short[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static String toString(char[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static String toString(byte[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static String toString(boolean[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static String toString(float[] a)

Parameters:

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

Returns:

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

Since:

1.5

public static String toString(double[] a)

Parameters:

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

Returns:

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

Since:

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)

Type Parameters:

T - тип элементов

Parameters:

array - массив, предполагается, что он не изменяется во время использования

Returns:

spliterator для элементов массива

Since:

1.8

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

Type Parameters:

T - тип элементов

Parameters:

array - массив, предполагается, что он не изменяется во время использования

startInclusive - первый индекс для охвата, включительно

endExclusive - индекс сразу после последнего индекса для охвата

Returns:

spliterator для элементов массива

Throws:

ArrayIndexOutOfBoundsException - если startInclusive отрицательный, endExclusive меньше startInclusive, или endExclusive больше размера массива

Since:

1.8

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

Parameters:

array - массив, предполагается, что он не изменяется во время использования

Returns:

spliterator для элементов массива

Since:

1.8

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

Parameters:

array - массив, предполагается, что он не изменяется во время использования

startInclusive - первый индекс для охвата, включительно

endExclusive - индекс сразу после последнего индекса для охвата

Returns:

spliterator для элементов массива

Throws:

ArrayIndexOutOfBoundsException - если startInclusive отрицательный, endExclusive меньше startInclusive, или endExclusive больше размера массива

Since:

1.8

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

Parameters:

array - массив, предполагается, что он не изменяется во время использования

Returns:

spliterator для элементов массива

Since:

1.8

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

Parameters:

array - массив, предполагается, что он не изменяется во время использования

startInclusive - первый индекс для охвата, включительно

endExclusive - индекс сразу после последнего индекса для охвата

Returns:

spliterator для элементов массива

Throws:

ArrayIndexOutOfBoundsException - если startInclusive отрицательный, endExclusive меньше startInclusive, или endExclusive больше размера массива

Since:

1.8

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

Parameters:

array - массив, предполагается, что он не изменяется во время использования

Returns:

spliterator для элементов массива

Since:

1.8

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

Parameters:

array - массив, предполагается, что он не изменяется во время использования

startInclusive - первый индекс для охвата, включительно

endExclusive - индекс сразу после последнего индекса для охвата

Returns:

spliterator для элементов массива

Throws:

ArrayIndexOutOfBoundsException - если startInclusive отрицательный, endExclusive меньше startInclusive, или endExclusive больше размера массива

Since:

1.8

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

Type Parameters:

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

Parameters:

array - массив, предполагается, что он не изменяется во время использования

Returns:

Stream для массива

Since:

1.8

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

Type Parameters:

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

Parameters:

array - массив, предполагается, что он не изменяется во время использования

startInclusive - первый индекс для охвата, включительно

endExclusive - индекс сразу после последнего индекса для охвата

Returns:

Stream для диапазона массива

Throws:

ArrayIndexOutOfBoundsException - если startInclusive отрицательный, endExclusive меньше startInclusive, или endExclusive больше размера массива

Since:

1.8

public static IntStream stream(int[] array)

Parameters:

array - массив, предполагается, что он не изменяется во время использования

Returns:

IntStream для массива

Since:

1.8

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

Параметры:

array - массив, предполагается, что он не изменяется во время использования

startInclusive - первый индекс для покрытия, включительно

endExclusive - индекс, непосредственно следующий за последним индексом для покрытия

Возвращает:

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

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

ArrayIndexOutOfBoundsException - если startInclusive отрицателен, endExclusive меньше startInclusive или endExclusive больше размера массива

С:

1.8

public static LongStream stream(long[] array)

Параметры:

array - массив, предполагается, что он не изменяется во время использования

Возвращает:

a LongStream для массива

С:

1.8

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

Параметры:

array - массив, предполагается, что он не изменяется во время использования

startInclusive - первый индекс для покрытия, включительно

endExclusive - индекс, непосредственно следующий за последним индексом для покрытия

Возвращает:

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

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

ArrayIndexOutOfBoundsException - если startInclusive отрицателен, endExclusive меньше startInclusive или endExclusive больше размера массива

С:

1.8

public static DoubleStream stream(double[] array)

Параметры:

array - массив, предполагается, что он не изменяется во время использования

Возвращает:

a DoubleStream для массива

С:

1.8

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

Параметры:

array - массив, предполагается, что он не изменяется во время использования

startInclusive - первый индекс для покрытия, включительно

endExclusive - индекс, непосредственно следующий за последним индексом для покрытия

Возвращает:

a 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 Note:

Этот метод ведет себя так, как если бы:

     int i = Arrays.mismatch(a, aFromIndex, aToIndex,
                             b, bFromIndex, bToIndex);
     if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
         return Byte.compare(a[aFromIndex + i], b[bFromIndex + i]);
     return (aToIndex - aFromIndex) - (bToIndex - bFromIndex);
 

Параметры:

a - первый массив для сравнения

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

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

b - второй массив для сравнения

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

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

Возвращает:

значение 0, если в указанных диапазонах первый и второй массивы равны и содержат одни и те же элементы в том же порядке; значение меньше чем 0, если в указанных диапазонах первый массив лексикографически меньше второго массива; и значение больше чем 0, если в указанных диапазонах первый массив лексикографически больше второго массива

Исключение:

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

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

NullPointerException - если любой из массивов равен `null`

С:

9

public static int compareUnsigned(byte[] a, byte[] b)

API Note:

Этот метод ведет себя так, как если бы (для ссылок на массивы, не равные `null`):

     int i = Arrays.mismatch(a, b);
     if (i >= 0 && i < Math.min(a.length, b.length))
         return Byte.compareUnsigned(a[i], b[i]);
     return a.length - b.length;
 

Параметры:

a - первый массив для сравнения

b - второй массив для сравнения

Возвращает:

значение 0, если первый и второй массивы равны и содержат одни и те же элементы в том же порядке; значение меньше чем 0, если первый массив лексикографически меньше второго массива; и значение больше чем 0, если первый массив лексикографически больше второго массива

С:

9

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

API Note:

Этот метод ведет себя так, как если бы:

     int i = Arrays.mismatch(a, aFromIndex, aToIndex,
                             b, bFromIndex, bToIndex);
     if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
         return Byte.compareUnsigned(a[aFromIndex + i], b[bFromIndex + i]);
     return (aToIndex - aFromIndex) - (bToIndex - bFromIndex);
 

Параметры:

a - первый массив для сравнения

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

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

b - второй массив для сравнения

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

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

Возвращает:

значение 0, если в указанных диапазонах первый и второй массивы равны и содержат одни и те же элементы в том же порядке; значение меньше чем 0, если в указанных диапазонах первый массив лексикографически меньше второго массива; и значение больше чем 0, если в указанных диапазонах первый массив лексикографически больше второго массива

Исключение:

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

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

NullPointerException - если любой из массивов равен `null`

С:

9

public static int compare(short[] a, short[] b)

     Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
 

API Note:

Этот метод ведет себя так, как если бы (для ссылок на массивы, не равные `null`):

     int i = Arrays.mismatch(a, b);
     if (i >= 0 && i < Math.min(a.length, b.length))
         return Short.compare(a[i], b[i]);
     return a.length - b.length;
 

Параметры:

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 Note:

Этот метод ведет себя так, как если бы:

     int i = Arrays.mismatch(a, aFromIndex, aToIndex,
                             b, bFromIndex, bToIndex);
     if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
         return Short.compare(a[aFromIndex + i], b[bFromIndex + i]);
     return (aToIndex - aFromIndex) - (bToIndex - bFromIndex);
 

Параметры:

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 Note:

Этот метод ведет себя так, как если бы (для ссылок на массивы, отличные от `short`):

     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 Note:

Этот метод ведет себя так, как если бы:

     int i = Arrays.mismatch(a, aFromIndex, aToIndex,
                             b, bFromIndex, bToIndex);
     if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
         return Short.compareUnsigned(a[aFromIndex + i], b[bFromIndex + i]);
     return (aToIndex - aFromIndex) - (bToIndex - bFromIndex);
 

Параметры:

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 Note:

Этот метод ведет себя так, как если бы (для ссылок на массивы, отличные от `char`):

     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 Note:

Этот метод ведет себя так, как будто:

     int i = Arrays.mismatch(a, aFromIndex, aToIndex,
                             b, bFromIndex, bToIndex);
     if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
         return Character.compare(a[aFromIndex + i], b[bFromIndex + i]);
     return (aToIndex - aFromIndex) - (bToIndex - bFromIndex);
 

Параметры:

a - первый массив для сравнения

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

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

b - второй массив для сравнения

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

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

Возвращает:

значение 0, если в заданных диапазонах первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше 0, если в заданных диапазонах первый массив лексикографически меньше второго массива; и значение больше 0, если в заданных диапазонах первый массив лексикографически больше второго массива

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

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

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

NullPointerException - если какой-либо массив null

С момента:

9

public static int compare(int[] a, int[] b)

     Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
 

API Note:

Этот метод ведет себя так, как будто (для ссылок на массивы, не являющиеся null):

     int i = Arrays.mismatch(a, b);
     if (i >= 0 && i < Math.min(a.length, b.length))
         return Integer.compare(a[i], b[i]);
     return a.length - b.length;
 

Параметры:

a - первый массив для сравнения

b - второй массив для сравнения

Возвращает:

значение 0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше 0, если первый массив лексикографически меньше второго массива; и значение больше 0, если первый массив лексикографически больше второго массива

С момента:

9

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 Note:

Этот метод ведет себя так, как будто:

     int i = Arrays.mismatch(a, aFromIndex, aToIndex,
                             b, bFromIndex, bToIndex);
     if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
         return Integer.compare(a[aFromIndex + i], b[bFromIndex + i]);
     return (aToIndex - aFromIndex) - (bToIndex - bFromIndex);
 

Параметры:

a - первый массив для сравнения

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

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

b - второй массив для сравнения

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

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

Возвращает:

значение 0, если в заданных диапазонах первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше 0, если в заданных диапазонах первый массив лексикографически меньше второго массива; и значение больше 0, если в заданных диапазонах первый массив лексикографически больше второго массива

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

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

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

NullPointerException - если какой-либо массив null

С момента:

9

public static int compareUnsigned(int[] a, int[] b)

API Note:

Этот метод ведет себя так, как будто (для ссылок на массивы, не являющиеся null):

     int i = Arrays.mismatch(a, b);
     if (i >= 0 && i < Math.min(a.length, b.length))
         return Integer.compareUnsigned(a[i], b[i]);
     return a.length - b.length;
 

Параметры:

a - первый массив для сравнения

b - второй массив для сравнения

Возвращает:

значение 0, если первый и второй массивы равны и содержат одинаковые элементы в том же порядке; значение меньше 0, если первый массив лексикографически меньше второго массива; и значение больше 0, если первый массив лексикографически больше второго массива

С момента:

9

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

API Note:

Этот метод ведет себя так, как если бы:

     int i = Arrays.mismatch(a, aFromIndex, aToIndex,
                             b, bFromIndex, bToIndex);
     if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
         return Integer.compareUnsigned(a[aFromIndex + i], b[bFromIndex + i]);
     return (aToIndex - aFromIndex) - (bToIndex - bFromIndex);
 

Параметры:

a - первый массив для сравнения

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

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

b - второй массив для сравнения

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

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

Возвращает:

значение 0, если в указанных диапазонах первый и второй массивы равны и содержат те же элементы в том же порядке; значение меньше 0, если в указанных диапазонах первый массив лексикографически меньше второго; и значение больше 0, если в указанных диапазонах первый массив лексикографически больше второго

Исключения:

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

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

NullPointerException - если любой из массивов равен null

С:

9

public static int compare(long[] a, long[] b)

     Arrays.equals(a, b) == (Arrays.compare(a, b) == 0)
 

API Note:

Этот метод ведет себя так, как если бы (для ссылок на массивы, не являющиеся `long`):

     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 Note:

Этот метод ведет себя так, как если бы:

     int i = Arrays.mismatch(a, aFromIndex, aToIndex,
                             b, bFromIndex, bToIndex);
     if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
         return Long.compare(a[aFromIndex + i], b[bFromIndex + i]);
     return (aToIndex - aFromIndex) - (bToIndex - bFromIndex);
 

Параметры:

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 Note:

Этот метод ведет себя так, как если бы (для ссылок на массивы, не являющиеся `long`):

     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 Note:

Этот метод ведет себя так, как если бы:

     int i = Arrays.mismatch(a, aFromIndex, aToIndex,
                             b, bFromIndex, bToIndex);
     if (i >= 0 && i < Math.min(aToIndex - aFromIndex, bToIndex - bFromIndex))
         return Long.compareUnsigned(a[aFromIndex + i], b[bFromIndex + i]);
     return (aToIndex - aFromIndex) - (bToIndex - bFromIndex);
 

Параметры:

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

public static int compare(double[] a, double[] 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 Double.compare(a[i], b[i]);
     return a.length - b.length;
 

Параметры:

a - первый массив для сравнения

b - второй массив для сравнения

Возвращает:

значение 0, если первый и второй массивы равны и содержат одни и те же элементы в том же порядке; значение, меньшее 0, если первый массив лексикографически меньше второго массива; и значение, большее 0, если первый массив лексикографически больше второго массива

С:

9