Класс Arrays

Этот класс содержит различные методы для работы с массивами (например, сортировки и поиска). Этот класс также содержит статический фабричный метод, который позволяет рассматривать массивы как списки.

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

Документация методов данного класса включает краткие описания реализаций. Такие описания следует рассматривать как примечания к реализации, а не как часть спецификации. Реализаторы могут использовать другие алгоритмы, при условии, что сама спецификация соблюдается. (Например, алгоритм, используемый sort(Object[]) не обязан быть MergeSort, но он должен быть стабильным.)

Этот класс является частью Java Collections Framework.

Методы

sort

public static void sort(int[] a)

Параметры:

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

sort

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

sort

public static void sort(long[] a)

Параметры:

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

sort

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

sort

public static void sort(short[] a)

Параметры:

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

sort

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

sort

public static void sort(char[] a)

Параметры:

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

sort

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

sort

public static void sort(byte[] a)

Параметры:

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

sort

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

sort

public static void sort(float[] a)

Параметры:

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

sort

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

sort

public static void sort(double[] a)

Параметры:

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

sort

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

parallelSort

public static void parallelSort(byte[] a)

Сортирует указанный массив в порядке возрастания.

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

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

Параметры:

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

С тех пор:

1.8

parallelSort

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

Сортирует указанный диапазон массива в порядке возрастания числовых значений. Диапазон, подлежащий сортировке, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. Если fromIndex == toIndex, диапазон, подлежащий сортировке, пуст.

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

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

Начиная с:

1.8

parallelSort

public static void parallelSort(char[] a)

Сортирует указанный массив в порядке возрастания числовых значений.

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

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

Параметры:

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

Начиная с:

1.8

parallelSort

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

Сортирует указанный диапазон массива в порядке возрастания числовых значений. Диапазон, подлежащий сортировке, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. Если fromIndex == toIndex, диапазон, подлежащий сортировке, пуст.

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

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.8

parallelSort

public static void parallelSort(short[] a)

Сортирует указанный массив в порядке возрастания числовых значений.

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

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

Параметры:

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

С:

1.8

parallelSort

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

Сортирует указанный диапазон массива в порядке возрастания числовых значений. Диапазон, подлежащий сортировке, простирается от индекса fromIndex, включительно, до индекса toIndex, не включая. Если fromIndex == toIndex, диапазон, подлежащий сортировке, пустой.

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

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.8

parallelSort

public static void parallelSort(int[] a)

Сортирует указанный массив в порядке возрастания.

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

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

Параметры:

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

С:

1.8

parallelSort

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

Сортирует указанный диапазон массива в порядке возрастания. Диапазон для сортировки простирается от индекса fromIndex, включительно, до индекса toIndex, исключая. Если fromIndex == toIndex, диапазон для сортировки пуст.

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

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.8

parallelSort

public static void parallelSort(long[] a)

Сортирует указанный массив в порядке возрастания.

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

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

Параметры:

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

С:

1.8

parallelSort

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

Сортирует указанный диапазон массива в порядке возрастания. Диапазон, подлежащий сортировке, простирается от индекса fromIndex, включительно, до индекса toIndex, исключая. Если fromIndex == toIndex, диапазон, подлежащий сортировке, пустой.

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

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

Параметры:

a — массив, который требуется отсортировать

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

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

Исключения:

IllegalArgumentException — если fromIndex > toIndex

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

С:

1.8

parallelSort

public static void parallelSort(float[] a)

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

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

Параметры:

a — массив, который требуется отсортировать

С:

1.8

parallelSort

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

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

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.8

parallelSort

public static void parallelSort(double[] a)

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

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

Параметры:

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

С:

1.8

parallelSort

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

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

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

Параметры:

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

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

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

Исключение:

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.8

parallelSort

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

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

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

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

T — класс объектов, которые будут отсортированы

Параметры:

a — массив, который будет отсортирован

Исключения:

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

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

С:

1.8

parallelSort

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

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

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

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

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

Параметры:

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

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

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

Исключения:

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

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

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

С момента:

1.8

parallelSort

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

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

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

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

T — класс объектов, которые необходимо отсортировать

Параметры:

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

cmp — компаратор для определения порядка элементов массива. Значение null указывает на то, что необходимо использовать естественный порядок элементов (согласно интерфейсу Comparable).

Исключения:

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

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

С тех пор:

1.8

parallelSort

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

sort

public static void sort(Object[] a)

Параметры:

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

Исключения:

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

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

sort

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

Параметры:

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

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

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

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

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

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

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

sort

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

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

T - класс объектов, подлежащих сортировке

Параметры:

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

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

Исключения:

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

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

sort

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

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

T - класс объектов, подлежащих сортировке

Параметры:

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

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

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

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

Исключения:

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

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

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

parallelPrefix

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

Вычисляет кумулятивное значение каждого элемента заданного массива на месте в параллельном режиме, используя предоставленную функцию. Например, если массив изначально содержит [2, 1, 0, 3] и операция выполняет сложение, то после выполнения метода массив содержит [2, 3, 3, 6]. Вычисление параллельного префикса обычно более эффективно, чем последовательные циклы для больших массивов.

Тип параметров:

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

Параметры:

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

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

Исключения:

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

С:

1.8

parallelPrefix

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

Выполняет parallelPrefix(Object[], BinaryOperator) для заданного поддиапазона массива.

Тип параметров:

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

Параметры:

array - массив

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

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

С:

1.8

parallelPrefix

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

Вычисляет кумулятивное значение каждого элемента заданного массива на месте в параллельном режиме, используя предоставленную функцию. Например, если массив изначально содержит [2, 1, 0, 3] и операция выполняет сложение, то после выполнения метода массив содержит [2, 3, 3, 6]. Вычисление параллельного префикса обычно более эффективно, чем последовательные циклы для больших массивов.

Параметры:

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

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

Исключения:

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

С:

1.8

parallelPrefix

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

Выполняет parallelPrefix(long[], LongBinaryOperator) для заданного поддиапазона массива.

Параметры:

array - массив

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

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

С:

1.8

parallelPrefix

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

Параметры:

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

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

Исключения:

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

С:

1.8

parallelPrefix

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

Выполняет parallelPrefix(double[], DoubleBinaryOperator) для заданного поддиапазона массива.

Параметры:

array - массив

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

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

С:

1.8

parallelPrefix

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

Накапливает, в параллельном режиме, каждый элемент заданного массива на месте, используя предоставленную функцию. Например, если массив изначально содержит [2, 1, 0, 3] и операция выполняет сложение, то по возвращении массив содержит [2, 3, 3, 6]. Параллельное вычисление префикса обычно более эффективно, чем последовательные циклы для больших массивов.

Параметры:

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

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

Исключения:

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

С тех пор:

1.8

parallelPrefix

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

Выполняет parallelPrefix(int[], IntBinaryOperator) для заданного поддиапазона массива.

Параметры:

array - массив

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

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

С тех пор:

1.8

binarySearch

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

Ищет заданное значение в заданном массиве long с помощью алгоритма бинарного поиска. Массив должен быть отсортирован (как методом sort(long[])) перед вызовом этого метода. Если он не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.

Параметры:

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

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

Возвращает:

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

binarySearch

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

Ищет указанное значение в заданном диапазоне массива long с использованием алгоритма бинарного поиска. Диапазон должен быть отсортирован (как методом sort(long[], int, int)) перед выполнением этого вызова. Если он не отсортирован, результаты не определены. Если диапазон содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.

Параметры:

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

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

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

key - значение, которое ищется

Возвращает:

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.6

binarySearch

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

Ищет указанное значение в заданном массиве int с использованием алгоритма бинарного поиска. Массив должен быть отсортирован (как методом sort(int[])) перед выполнением этого вызова. Если он не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.

Параметры:

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

key - значение, которое ищется

Возвращает:

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

binarySearch

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

Ищет значение в заданном массиве целых чисел в заданном диапазоне с помощью алгоритма бинарного поиска. Диапазон должен быть отсортирован (как методом sort(int[], int, int)) перед вызовом этого метода. Если он не отсортирован, результаты не определены. Если массив содержит несколько элементов со значением, которое ищется, нет гарантии, какой из них будет найден.

Параметры:

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

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

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

key - значение, которое нужно найти

Возвращает:

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

Исключение:

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.6

binarySearch

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

Ищет заданное значение в заданном массиве значений типа short с использованием алгоритма бинарного поиска. Массив должен быть отсортирован (как методом sort(short[])) перед вызовом этого метода. Если он не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.

Параметры:

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

key - значение, которое нужно найти

Возвращает:

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

binarySearch

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

Ищет значение в заданном диапазоне массива байтов с помощью алгоритма двоичного поиска. Диапазон должен быть отсортирован (как с помощью метода sort(short[], int, int)) перед вызовом. Если он не отсортирован, результаты не определены. Если массив содержит несколько элементов со значением, которое ищется, нет гарантии, какой из них будет найден.

Параметры:

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

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

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

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

Возвращает:

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

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

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.6

binarySearch

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

Ищет указанное значение в заданном массиве символов с помощью алгоритма двоичного поиска. Массив должен быть отсортирован (как с помощью метода sort(char[])) перед вызовом. Если он не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.

Параметры:

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

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

Возвращает:

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

binarySearch

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

Ищет в заданном диапазоне массива символов указанное значение с помощью алгоритма двоичного поиска. Диапазон должен быть отсортирован (как методом sort(char[], int, int)) перед вызовом этого метода. Если он не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.

Параметры:

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

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

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

key - значение, которое нужно найти

Возвращает:

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

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

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.6

binarySearch

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

Ищет в заданном массиве байтов указанное значение с помощью алгоритма двоичного поиска. Массив должен быть отсортирован (как методом sort(byte[])) перед вызовом этого метода. Если он не отсортирован, результаты не определены. Если массив содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден.

Параметры:

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

key - значение, которое нужно найти

Возвращает:

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

binarySearch

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

Ищет заданное значение в заданном диапазоне массива байтов, используя алгоритм бинарного поиска. Диапазон должен быть отсортирован (например, методом sort(byte[], int, int)) перед вызовом этого метода. Если он не отсортирован, результаты будут неопределёнными. Если в диапазоне есть несколько элементов со значением, гарантируется, что будет найден любой из них.

Параметры:

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

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

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

key - значение, которое нужно найти

Возвращает:

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

Вызывает:

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.6

binarySearch

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

Ищет заданное значение в заданном массиве чисел с плавающей точкой двойной точности, используя алгоритм бинарного поиска. Массив должен быть отсортирован (например, методом sort(double[])) перед вызовом этого метода. Если он не отсортирован, результаты будут неопределенными. Если в массиве есть несколько элементов с указанным значением, нет гарантии, какой из них будет найден. Этот метод рассматривает все значения NaN как эквивалентные и равные.

Параметры:

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

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

Возвращает:

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

binarySearch

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

Ищет значение в указанном диапазоне массива double с помощью алгоритма бинарного поиска. Диапазон должен быть отсортирован (как методом sort(double[], int, int)) перед выполнением этого вызова. Если он не отсортирован, результаты неопределённы. Если диапазон содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден. Этот метод считает все значения NaN эквивалентными и равными.

Параметры:

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

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

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

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

Возвращает:

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

Исключение:

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.6

binarySearch

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

Ищет указанное значение в заданном массиве float с помощью алгоритма бинарного поиска. Массив должен быть отсортирован (как методом sort(float[])) перед вызовом. Если он не отсортирован, результаты неопределённы. Если массив содержит несколько элементов с указанным значением, нет гарантии, какой из них будет найден. Этот метод считает все значения NaN эквивалентными и равными.

Параметры:

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

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

Возвращает:

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

binarySearch

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

Ищет значение в указанном диапазоне массива с плавающей точкой, используя алгоритм бинарного поиска. Диапазон должен быть отсортирован (например, методом sort(float[], int, int)) перед вызовом этого метода. Если он не отсортирован, результаты не определены. Если диапазон содержит несколько элементов с заданным значением, нет гарантии, какой из них будет найден. Этот метод считает все значения NaN эквивалентными и равными.

Параметры:

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

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

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

key - значение, для которого нужно выполнить поиск

Возвращает:

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

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

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.6

binarySearch

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

Ищет указанный объект в заданном массиве, используя алгоритм бинарного поиска. Массив должен быть отсортирован по возрастанию в соответствии с естественным порядком его элементов (как методом sort(Object[])) перед вызовом этого метода. Если он не отсортирован, результаты не определены. (Если массив содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа), его нельзя отсортировать в соответствии с естественным порядком его элементов, поэтому результаты не определены.) Если массив содержит несколько элементов, равных указанному объекту, нет гарантии, какой из них будет найден.

Параметры:

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

key - значение, которое ищется

Возвращает:

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

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

ClassCastException - если ключ поиска не сравним с элементами массива.

binarySearch

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

Ищет в заданном диапазоне массива указанный объект, используя алгоритм бинарного поиска. Диапазон должен быть отсортирован в порядке возрастания в соответствии с естественным порядком своих элементов (как и методом sort(Object[], int, int)) перед вызовом этого метода. Если он не отсортирован, результаты не определены. (Если диапазон содержит элементы, которые не могут быть взаимно сравнимы (например, строки и целые числа), он не может быть отсортирован в соответствии с естественным порядком своих элементов, поэтому результаты не определены.) Если диапазон содержит несколько элементов, равных указанному объекту, нет гарантии, какой из них будет найден.

Параметры:

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

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

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

key - значение, которое ищется

Возвращает:

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

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

ClassCastException - если ключ поиска не сравним с элементами массива в указанном диапазоне.

IllegalArgumentException - если fromIndex > toIndex

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

С:

1.6

binarySearch

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

Ищет указанный объект в заданном массиве с помощью алгоритма двоичного поиска. Массив должен быть отсортирован в порядке возрастания согласно заданному компаратору (как при помощи метода sort(T[], Comparator)) до вызова этого метода. Если массив не отсортирован, результаты не определены. Если массив содержит несколько элементов, равных указанному объекту, нет гарантии, какой из них будет найден.

Type Parameters:

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

Parameters:

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

key - значение, которое необходимо найти

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

Returns:

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

Throws:

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

binarySearch

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

Ищет указанный объект в заданном диапазоне массива с помощью алгоритма двоичного поиска. Диапазон должен быть отсортирован в порядке возрастания согласно заданному компаратору (как при помощи метода sort(T[], int, int, Comparator)) до вызова этого метода. Если диапазон не отсортирован, результаты не определены. Если диапазон содержит несколько элементов, равных указанному объекту, нет гарантии, какой из них будет найден.

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

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

Параметры:

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

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

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

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

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

Возвращает:

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

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

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

IllegalArgumentException — если fromIndex > toIndex

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

С тех пор:

1.6

equals

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

Параметры:

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

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

Возвращает:

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

equals

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

Параметры:

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

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

Возвращает:

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

equals

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

Параметры:

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

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

Возвращает:

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

equals

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

Параметры:

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

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

Возвращает:

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

equals

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

Параметры:

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

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

Возвращает:

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

equals

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

Параметры:

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

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

Возвращает:

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

equals

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

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

Параметры:

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

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

Возвращает:

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

См. также:

Double.equals(Object)

equals

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

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

Параметры:

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

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

Возвращает:

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

См. также:

Float.equals(Object)

equals

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

Параметры:

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

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

Возвращает:

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

fill

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

Присваивает указанное значение long каждому элементу заданного массива long.

Параметры:

a - массив, подлежащий заполнению

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

fill

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

Присваивает указанное значение long каждому элементу заданного диапазона указанного массива long. Диапазон, подлежащий заполнению, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон, подлежащий заполнению, пуст.)

Параметры:

a - массив, подлежащий заполнению

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

fill

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

Присваивает указанное значение int каждому элементу указанного массива int.

Параметры:

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

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

fill

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

Присваивает указанное целое значение каждому элементу указанного диапазона заданного массива целых чисел. Диапазон, который нужно заполнить, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон для заполнения пустой.)

Параметры:

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

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

fill

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

Присваивает указанное значение типа short каждому элементу указанного массива значений типа short.

Параметры:

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

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

fill

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

Присваивает указанное значение типа short каждому элементу указанного диапазона заданного массива значений типа short. Диапазон, который нужно заполнить, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон для заполнения пустой.)

Параметры:

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

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

fill

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

Присваивает указанное значение типа char каждому элементу указанного массива символов.

Параметры:

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

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

fill

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

Присваивает указанное значение char каждому элементу указанного диапазона заданного массива char. Диапазон, который будет заполнен, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон для заполнения пустой.)

Параметры:

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

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

fill

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

Присваивает указанное значение byte каждому элементу заданного массива байтов.

Параметры:

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

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

fill

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

Присваивает указанное значение byte каждому элементу указанного диапазона заданного массива байтов. Диапазон, который будет заполнен, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон для заполнения пустой.)

Параметры:

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

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

fill

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

Присваивает указанное логическое значение каждому элементу указанного массива булевых значений.

Параметры:

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

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

fill

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

Присваивает указанное булево значение каждому элементу указанного диапазона заданного массива булевых значений. Диапазон, который нужно заполнить, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон для заполнения пуст.)

Параметры:

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

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

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

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

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

IllegalArgumentException - если fromIndex > toIndex

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

fill

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

Присваивает указанное значение типа double каждому элементу заданного массива double.

Параметры:

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

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

fill

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

Присваивает указанное значение типа double каждому элементу указанного диапазона заданного массива double. Диапазон, который нужно заполнить, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон для заполнения пуст.)

Параметры:

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

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

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

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

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

IllegalArgumentException - если fromIndex > toIndex

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

fill

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

Присваивает указанное значение типа float каждому элементу заданного массива float.

Параметры:

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

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

fill

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

Присваивает указанное значение с плавающей точкой каждому элементу указанного диапазона указанного массива с плавающей точкой. Диапазон, который будет заполнен, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон, который будет заполнен, пуст.)

Параметры:

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

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

fill

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

Присваивает указанную ссылку на объект каждому элементу указанного массива объектов.

Параметры:

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

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

Исключения:

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

fill

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

Присваивает указанную ссылку на объект каждому элементу указанного диапазона указанного массива объектов. Диапазон, который будет заполнен, простирается от индекса fromIndex, включительно, до индекса toIndex, не включительно. (Если fromIndex==toIndex, диапазон, который будет заполнен, пуст.)

Параметры:

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

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

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

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

Исключения:

IllegalArgumentException - если fromIndex > toIndex

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

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

copyOf

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

Копирует указанный массив, усекая или заполняя нулями (при необходимости) так, чтобы копия имела указанную длину. Для всех индексов, которые являются допустимыми как в исходном массиве, так и в копии, оба массива будут содержать идентичные значения. Для любых индексов, которые являются допустимыми в копии, но не в исходном массиве, копия будет содержать null. Такие индексы будут существовать только в том случае, если указанная длина больше, чем длина исходного массива. Результирующий массив имеет точно такой же класс, что и исходный массив.

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

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

Параметры:

original - копируемый массив

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

Возвращаемое значение:

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

Исключения:

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

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

С момента:

1.6

copyOf

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

Копирует указанный массив, усекая или заполняя нулями (при необходимости), чтобы копия имела заданную длину. Для всех индексов, которые являются допустимыми как в исходном массиве, так и в копии, два массива будут содержать одинаковые значения. Для любых индексов, которые допустимы в копии, но не в исходном массиве, копия будет содержать null. Такие индексы будут существовать только тогда, когда заданная длина больше длины исходного массива. Результирующий массив имеет класс newType.

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

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

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

Параметры:

original - копируемый массив

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

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

Возвращаемое значение:

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

Исключения:

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

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

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

С момента:

1.6

copyOf

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

Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. Для всех индексов, которые являются допустимыми как в исходном массиве, так и в копии, оба массива будут содержать одинаковые значения. Для любых индексов, допустимых в копии, но не в исходном массиве, копия будет содержать (byte)0. Такие индексы будут существовать только в том случае, если указанная длина больше длины исходного массива.

Параметры:

original - массив, который должен быть скопирован

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

Возвращает:

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

Исключения:

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

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

С:

1.6

copyOf

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

Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. Для всех индексов, которые являются допустимыми как в исходном массиве, так и в копии, оба массива будут содержать одинаковые значения. Для любых индексов, допустимых в копии, но не в исходном массиве, копия будет содержать (short)0. Такие индексы будут существовать только в том случае, если указанная длина больше длины исходного массива.

Параметры:

original - массив, который должен быть скопирован

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

Возвращает:

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

Исключения:

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

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

С:

1.6

copyOf

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

Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. Для всех индексов, которые являются допустимыми как в исходном массиве, так и в копии, оба массива будут содержать одинаковые значения. Для любых индексов, допустимых в копии, но не в исходном массиве, копия будет содержать 0. Такие индексы будут существовать только в том случае, если указанная длина больше длины исходного массива.

Параметры:

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

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

Возвращает:

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

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

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

NullPointerException - если original null

С момента:

1.6

copyOf

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

Копирует указанный массив, усекая или дополняя нулями (при необходимости), чтобы копия имела указанную длину. Для всех индексов, которые допустимы как в исходном массиве, так и в копии, оба массива будут содержать идентичные значения. Для любых индексов, которые допустимы в копии, но не в исходном массиве, копия будет содержать 0L. Такие индексы существуют тогда и только тогда, когда указанная длина больше длины исходного массива.

Параметры:

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

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

Возвращает:

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

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

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

NullPointerException - если original null

С момента:

1.6

copyOf

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

Копирует указанный массив, усекая или дополняя нулевыми символами (при необходимости), чтобы копия имела указанную длину. Для всех индексов, которые допустимы как в исходном массиве, так и в копии, оба массива будут содержать идентичные значения. Для любых индексов, которые допустимы в копии, но не в исходном массиве, копия будет содержать '\\u000'. Такие индексы существуют тогда и только тогда, когда указанная длина больше длины исходного массива.

Параметры:

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

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

Возвращает:

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

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

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

NullPointerException - если original null

С момента:

1.6

copyOf

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

Копирует указанный массив, обрезая или заполняя нулями (при необходимости), чтобы копия имела указанную длину. Для всех индексов, которые являются допустимыми как в исходном массиве, так и в копии, оба массива будут содержать идентичные значения. Для любых индексов, которые являются допустимыми в копии, но не в исходном массиве, копия будет содержать 0f. Такие индексы будут существовать только в том случае, если заданная длина больше длины исходного массива.

Параметры:

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

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

Возвращает:

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

Исключения:

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

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

С:

1.6

copyOf

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

Копирует указанный массив, обрезая или заполняя нулями (при необходимости), чтобы копия имела указанную длину. Для всех индексов, которые являются допустимыми как в исходном массиве, так и в копии, оба массива будут содержать идентичные значения. Для любых индексов, которые являются допустимыми в копии, но не в исходном массиве, копия будет содержать 0d. Такие индексы будут существовать только в том случае, если заданная длина больше длины исходного массива.

Параметры:

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

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

Возвращает:

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

Исключения:

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

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

С:

1.6

copyOf

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

Копирует указанный массив, обрезая или заполняя false (при необходимости), чтобы копия имела указанную длину. Для всех индексов, которые являются допустимыми как в исходном массиве, так и в копии, оба массива будут содержать идентичные значения. Для любых индексов, которые являются допустимыми в копии, но не в исходном массиве, копия будет содержать false. Такие индексы будут существовать только в том случае, если заданная длина больше длины исходного массива.

Параметры:

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

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

Возвращает:

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

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

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

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

С:

1.6

copyOfRange

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

Тип параметров:

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

Параметры:

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

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

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

Возвращает:

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

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

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

IllegalArgumentException - если from > to

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

С:

1.6

copyOfRange

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

Копирует указанный диапазон из указанного массива в новый массив. Начальный индекс диапазона (from) должен находиться в диапазоне от нуля до original.length, включительно. Значение по индексу original[from] помещается в начальный элемент копии (если from == original.length или from == to не выполняются). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае null помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from. Возвращаемый массив относится к классу newType.

Типы параметров:

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

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

Параметры:

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

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

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

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

Возвращает:

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

Исключение:

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

IllegalArgumentException - если from > to

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

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

С тех пор:

1.6

copyOfRange

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

Копирует указанный диапазон заданного массива в новый массив. Начальный индекс диапазона (from) должен находиться в диапазоне от нуля до original.length, включительно. Значение по индексу original[from] помещается в начальный элемент копии (если не from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае (byte)0 помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

IllegalArgumentException - если from > to

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

С:

1.6

copyOfRange

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

Копирует указанный диапазон заданного массива в новый массив. Начальный индекс диапазона (from) должен находиться в диапазоне от нуля до original.length, включительно. Значение по индексу original[from] помещается в начальный элемент копии (если не from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае (short)0 помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.

Параметры:

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

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

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

Возвращает:

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

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

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

IllegalArgumentException - если from > to

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

С:

1.6

copyOfRange

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

Копирует указанный диапазон заданного массива в новый массив. Начальный индекс диапазона (from) должен лежать между нулём и original.length, включительно. Значение в original[from] помещается в начальный элемент копии (если from == original.length или from == to). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае 0 помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.

Параметры:

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

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

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

Возвращает:

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

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

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

IllegalArgumentException - если from > to

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

С:

1.6

copyOfRange

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

Копирует указанный диапазон заданного массива в новый массив. Начальный индекс диапазона (from) должен лежать между нулем и original.length, включительно. Значение в original[from] помещается в начальный элемент копии (если from == original.length или from == to не выполняются). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае 0L помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.

Параметры:

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

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

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

Возвращает:

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

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

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

IllegalArgumentException - если from > to

NullPointerException - если original имеет значение null

С:

1.6

copyOfRange

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

Копирует указанный диапазон заданного массива в новый массив. Начальный индекс диапазона (from) должен лежать между нулем и original.length, включительно. Значение в original[from] помещается в начальный элемент копии (если from == original.length или from == to не выполняются). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае '\\u000' помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

IllegalArgumentException - если from > to

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

С момента:

1.6

copyOfRange

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

Копирует указанный диапазон из указанного массива в новый массив. Начальный индекс диапазона (from) должен лежать между нулем и original.length, включительно. Значение в позиции original[from] помещается в начальный элемент копии (если from == original.length или from == to не выполняются). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае 0f помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

IllegalArgumentException - если from > to

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

С момента:

1.6

copyOfRange

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

Копирует указанный диапазон заданного массива в новый массив. Начальный индекс диапазона (from) должен находиться в пределах от нуля до original.length, включительно. Значение в original[from] помещается в начальный элемент копии (если from == original.length или from == to не выполняются). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае 0d помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

IllegalArgumentException - если from > to

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

С тех пор как:

1.6

copyOfRange

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

Копирует указанный диапазон заданного массива в новый массив. Начальный индекс диапазона (from) должен находиться в пределах от нуля до original.length, включительно. Значение в original[from] помещается в начальный элемент копии (если from == original.length или from == to не выполняются). Значения из последующих элементов исходного массива помещаются в последующие элементы копии. Конечный индекс диапазона (to), который должен быть больше или равен from, может быть больше original.length, в этом случае false помещается во все элементы копии, индекс которых больше или равен original.length - from. Длина возвращаемого массива будет to - from.

Параметры:

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

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

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

Возвращает:

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

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

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

IllegalArgumentException - если from > to

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

С:

1.6

asList

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

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

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

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

Параметры:

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

Возвращает:

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

hashCode

public static int hashCode(long[] a)

Параметры:

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

Возвращает:

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

С:

1.5

hashCode

public static int hashCode(int[] a)

Параметры:

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

Возвращает:

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

С:

1.5

hashCode

public static int hashCode(short[] a)

Параметры:

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

Возвращает:

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

С:

1.5

hashCode

public static int hashCode(char[] a)

Параметры:

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

Возвращает:

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

С:

1.5

hashCode

public static int hashCode(byte[] a)

Параметры:

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

Возвращает:

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

С:

1.5

hashCode

public static int hashCode(boolean[] a)

Параметры:

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

Возвращает:

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

С:

1.5

hashCode

public static int hashCode(float[] a)

Parameters:

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

Returns:

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

Since:

1.5

hashCode

public static int hashCode(double[] a)

Parameters:

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

Returns:

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

Since:

1.5

hashCode

public static int hashCode(Object[] a)

Параметры:

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

Возвращает:

хэш-код на основе содержимого для a

С:

1.5

См. также:

deepHashCode(Object[])

deepHashCode

public static int deepHashCode(Object[] a)

Параметры:

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

Возвращает:

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

С:

1.5

См. также:

hashCode(Object[])

deepEquals

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)

toString

public static String toString(long[] a)

Возвращает строковое представление содержимого указанного массива. Строковое представление состоит из списка элементов массива, заключённых в квадратные скобки ("[]"). Соседние элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки как String.valueOf(long). Возвращает "null" если a является null.

Parameters:

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

Returns:

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

Since:

1.5

toString

public static String toString(int[] a)

Возвращает строковое представление содержимого указанного массива. Строковое представление состоит из списка элементов массива, заключенных в квадратные скобки ("[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки как в String.valueOf(int). Возвращает "null" если a равен null.

Параметры:

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

Возвращает:

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

С:

1.5

toString

public static String toString(short[] a)

Возвращает строковое представление содержимого указанного массива. Строковое представление состоит из списка элементов массива, заключенных в квадратные скобки ("[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки как в String.valueOf(short). Возвращает "null" если a равен null.

Параметры:

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

Возвращает:

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

С:

1.5

toString

public static String toString(char[] a)

Возвращает строковое представление содержимого указанного массива. Строковое представление состоит из списка элементов массива, заключенных в квадратные скобки ("[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки как в String.valueOf(char). Возвращает "null" если a равен null.

Параметры:

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

Возвращает:

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

С:

1.5

toString

public static String toString(byte[] a)

Возвращает строковое представление содержимого указанного массива. Строковое представление состоит из списка элементов массива, заключенных в квадратные скобки ("[]"). Смежные элементы разделяются символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки как в String.valueOf(byte). Возвращает "null" если a равен null.

Параметры:

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

Возвращает:

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

С тех пор:

1.5

toString

public static String toString(boolean[] a)

Возвращает строковое представление содержимого указанного массива. Строковое представление состоит из списка элементов массива, заключённых в квадратные скобки ("[]"). Смежные элементы разделены символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки так же, как в String.valueOf(boolean). Возвращает "null", если a является null.

Параметры:

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

Возвращает:

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

С тех пор:

1.5

toString

public static String toString(float[] a)

Возвращает строковое представление содержимого указанного массива. Строковое представление состоит из списка элементов массива, заключённых в квадратные скобки ("[]"). Смежные элементы разделены символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки так же, как в String.valueOf(float). Возвращает "null", если a является null.

Параметры:

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

Возвращает:

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

С тех пор:

1.5

toString

public static String toString(double[] a)

Возвращает строковое представление содержимого указанного массива. Строковое представление состоит из списка элементов массива, заключённых в квадратные скобки ("[]"). Смежные элементы разделены символами ", " (запятая, за которой следует пробел). Элементы преобразуются в строки так же, как в String.valueOf(double). Возвращает "null", если a является null.

Параметры:

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

Возвращает:

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

С тех пор:

1.5

toString

public static String toString(Object[] a)

Параметры:

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

Возвращает:

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

С момента:

1.5

См. также:

deepToString(Object[])

deepToString

public static String deepToString(Object[] a)

Параметры:

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

Возвращает:

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

С момента:

1.5

См. также:

toString(Object[])

setAll

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

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

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

Параметры:

array - массив, который должен быть инициализирован

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

Исключения:

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

С тех пор:

1.8

parallelSetAll

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

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

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

Параметры:

array - массив, который должен быть инициализирован

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

Исключения:

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

С тех пор:

1.8

setAll

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

Параметры:

array - массив, который должен быть инициализирован

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

Исключения:

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

С тех пор:

1.8

parallelSetAll

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

Параметры:

array - массив, который должен быть инициализирован

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

Исключения:

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

С тех пор:

1.8

setAll

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

Параметры:

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

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

Исключения:

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

С:

1.8

parallelSetAll

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

Параметры:

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

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

Исключения:

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

С:

1.8

setAll

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

Параметры:

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

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

Исключения:

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

С:

1.8

parallelSetAll

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

Параметры:

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

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

Исключения:

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

С:

1.8

spliterator

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

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

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

Параметры:

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

Возвращает:

разделитель для элементов массива

С:

1.8

spliterator

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

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

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

Параметры:

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

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

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

Возвращает:

разделитель для элементов массива

Исключения:

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

С:

1.8

spliterator

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

Параметры:

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

Возвращает:

разделитель для элементов массива

С:

1.8

spliterator

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

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

С:

1.8

spliterator

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

Параметры:

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

Возвращает:

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

С:

1.8

spliterator

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

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

С:

1.8

spliterator

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

Параметры:

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

Возвращает:

разделитель для элементов массива

С момента:

1.8

spliterator

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

Параметры:

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

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

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

Возвращает:

разделитель для элементов массива

Исключения:

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

С момента:

1.8

stream

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

Возвращает последовательный Stream с указанным массивом в качестве источника.

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

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

Параметры:

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

Возвращает:

поток для массива

С момента:

1.8

stream

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

Возвращает последовательный Stream с указанным диапазоном указанного массива в качестве источника.

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

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

Параметры:

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

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

endExclusive - индекс сразу за последним элементом, включая его

Возвращает:

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

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

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

С:

1.8

stream

public static IntStream stream(int[] array)

Возвращает последовательный IntStream с указанным массивом в качестве источника.

Параметры:

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

Возвращает:

поток IntStream для массива

С:

1.8

stream

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

Возвращает последовательный IntStream с указанным диапазоном указанного массива в качестве источника.

Параметры:

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

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

endExclusive - индекс сразу за последним элементом, включая его

Возвращает:

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

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

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

С:

1.8

stream

public static LongStream stream(long[] array)

Возвращает последовательный LongStream с указанным массивом в качестве источника.

Параметры:

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

Возвращает:

поток LongStream для массива

С:

1.8

stream

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

Возвращает последовательный LongStream с указанным диапазоном указанного массива в качестве источника.

Параметры:

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

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

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

Возвращает:

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

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

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

С:

1.8

stream

public static DoubleStream stream(double[] array)

Возвращает последовательный DoubleStream со специфицированным массивом в качестве источника.

Параметры:

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

Возвращает:

поток DoubleStream для массива

С:

1.8

stream

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

Возвращает последовательный DoubleStream с указанным диапазоном указанного массива в качестве источника.

Параметры:

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

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

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

Возвращает:

поток DoubleStream для диапазона массива

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

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

С:

1.8