Класс Spliterators

java.lang.Object

java.util.Spliterators

public final class Spliterators extends Object

Статические классы и методы для работы с экземплярами Spliterator и его специализациями для примитивных типов Spliterator.OfInt, Spliterator.OfLong и Spliterator.OfDouble или их создания.

С версии:

1.8

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`Spliterators.AbstractDoubleSpliterator`	Абстрактный `Spliterator.OfDouble`, реализующий `trySplit` для обеспечения ограниченного параллелизма.
`static class`	`Spliterators.AbstractIntSpliterator`	Абстрактный `Spliterator.OfInt`, реализующий `trySplit` для обеспечения ограниченного параллелизма.
`static class`	`Spliterators.AbstractLongSpliterator`	Абстрактный `Spliterator.OfLong`, реализующий `trySplit` для обеспечения ограниченного параллелизма.
`static class`	`Spliterators.AbstractSpliterator<T>`	Абстрактный `Spliterator`, реализующий `trySplit` для обеспечения ограниченного параллелизма.

Краткое описание методов

Модификатор и тип	Метод	Описание
`static Spliterator.OfDouble`	`emptyDoubleSpliterator()`	Создает пустой `Spliterator.OfDouble`
`static Spliterator.OfInt`	`emptyIntSpliterator()`	Создает пустой `Spliterator.OfInt`
`static Spliterator.OfLong`	`emptyLongSpliterator()`	Создает пустой `Spliterator.OfLong`
`static <T> Spliterator<T>`	`emptySpliterator()`	Создает пустой `Spliterator`
`static PrimitiveIterator.OfDouble`	`iterator(Spliterator.OfDouble spliterator)`	Создает `PrimitiveIterator.OfDouble` на основе `Spliterator.OfDouble`.
`static PrimitiveIterator.OfInt`	`iterator(Spliterator.OfInt spliterator)`	Создает `PrimitiveIterator.OfInt` на основе `Spliterator.OfInt`.
`static PrimitiveIterator.OfLong`	`iterator(Spliterator.OfLong spliterator)`	Создает `PrimitiveIterator.OfLong` на основе `Spliterator.OfLong`.
`static <T> Iterator<T>`	`iterator(Spliterator<? extends T> spliterator)`	Создает `Iterator` на основе `Spliterator`.
`static Spliterator.OfDouble`	`spliterator(double[] array, int additionalCharacteristics)`	Создает `Spliterator.OfDouble`, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.
`static Spliterator.OfDouble`	`spliterator(double[] array, int fromIndex, int toIndex, int additionalCharacteristics)`	Создает `Spliterator.OfDouble`, охватывающий диапазон элементов заданного массива и использующий настраиваемый набор характеристик сплитератора.
`static Spliterator.OfInt`	`spliterator(int[] array, int additionalCharacteristics)`	Создает `Spliterator.OfInt`, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.
`static Spliterator.OfInt`	`spliterator(int[] array, int fromIndex, int toIndex, int additionalCharacteristics)`	Создает `Spliterator.OfInt`, охватывающий диапазон элементов заданного массива и использующий настраиваемый набор характеристик сплитератора.
`static Spliterator.OfLong`	`spliterator(long[] array, int additionalCharacteristics)`	Создает `Spliterator.OfLong`, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.
`static Spliterator.OfLong`	`spliterator(long[] array, int fromIndex, int toIndex, int additionalCharacteristics)`	Создает `Spliterator.OfLong`, охватывающий диапазон элементов заданного массива и использующий настраиваемый набор характеристик сплитератора.
`static <T> Spliterator<T>`	`spliterator(Object[] array, int additionalCharacteristics)`	Создает `Spliterator`, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.
`static <T> Spliterator<T>`	`spliterator(Object[] array, int fromIndex, int toIndex, int additionalCharacteristics)`	Создает `Spliterator`, охватывающий диапазон элементов заданного массива и использующий настраиваемый набор характеристик сплитератора.
`static <T> Spliterator<T>`	`spliterator(Collection<? extends T> c, int characteristics)`	Создает `Spliterator`, используя `iterator` заданной коллекции в качестве источника элементов и сообщая ее `size` как исходный размер.
`static <T> Spliterator<T>`	`spliterator(Iterator<? extends T> iterator, long size, int characteristics)`	Создает `Spliterator`, используя заданный `Iterator` в качестве источника элементов и заданный первоначально сообщаемый размер.
`static Spliterator.OfDouble`	`spliterator(PrimitiveIterator.OfDouble iterator, long size, int characteristics)`	Создает `Spliterator.OfDouble`, используя заданный `DoubleStream.DoubleIterator` в качестве источника элементов и заданный первоначально сообщаемый размер.
`static Spliterator.OfInt`	`spliterator(PrimitiveIterator.OfInt iterator, long size, int characteristics)`	Создает `Spliterator.OfInt`, используя заданный `IntStream.IntIterator` в качестве источника элементов и заданный первоначально сообщаемый размер.
`static Spliterator.OfLong`	`spliterator(PrimitiveIterator.OfLong iterator, long size, int characteristics)`	Создает `Spliterator.OfLong`, используя заданный `LongStream.LongIterator` в качестве источника элементов и заданный первоначально сообщаемый размер.
`static <T> Spliterator<T>`	`spliteratorUnknownSize(Iterator<? extends T> iterator, int characteristics)`	Создает `Spliterator`, используя заданный `Iterator` в качестве источника элементов, без первоначальной оценки размера.
`static Spliterator.OfDouble`	`spliteratorUnknownSize(PrimitiveIterator.OfDouble iterator, int characteristics)`	Создает `Spliterator.OfDouble`, используя заданный `DoubleStream.DoubleIterator` в качестве источника элементов, без первоначальной оценки размера.
`static Spliterator.OfInt`	`spliteratorUnknownSize(PrimitiveIterator.OfInt iterator, int characteristics)`	Создает `Spliterator.OfInt`, используя заданный `IntStream.IntIterator` в качестве источника элементов, без первоначальной оценки размера.
`static Spliterator.OfLong`	`spliteratorUnknownSize(PrimitiveIterator.OfLong iterator, int characteristics)`	Создает `Spliterator.OfLong`, используя заданный `LongStream.LongIterator` в качестве источника элементов, без первоначальной оценки размера.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

Подробное описание методов

emptySpliterator

public static <T> Spliterator<T> emptySpliterator()

Создает пустой Spliterator

Пустой сплитератор сообщает о Spliterator.SIZED и Spliterator.SUBSIZED. Вызовы Spliterator.trySplit() всегда возвращают null.

Параметры типа:: T — тип элементов
Возвращает:: Пустой сплитератор

emptyIntSpliterator

public static Spliterator.OfInt emptyIntSpliterator()

Создает пустой Spliterator.OfInt

Пустой сплитератор сообщает о Spliterator.SIZED и Spliterator.SUBSIZED. Вызовы Spliterator.trySplit() всегда возвращают null.

Возвращает:: Пустой сплитератор

emptyLongSpliterator

public static Spliterator.OfLong emptyLongSpliterator()

Создает пустой Spliterator.OfLong

Пустой сплитератор сообщает о Spliterator.SIZED и Spliterator.SUBSIZED. Вызовы Spliterator.trySplit() всегда возвращают null.

Возвращает:: Пустой сплитератор

emptyDoubleSpliterator

public static Spliterator.OfDouble emptyDoubleSpliterator()

Создает пустой Spliterator.OfDouble

Пустой сплитератор сообщает о Spliterator.SIZED и Spliterator.SUBSIZED. Вызовы Spliterator.trySplit() всегда возвращают null.

Возвращает:: Пустой сплитератор

spliterator

public static <T> Spliterator<T> spliterator(Object[] array, int additionalCharacteristics)

Создает Spliterator, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.

Этот метод предоставлен для удобства реализации сплитераторов, которые хранят части своих элементов в массивах и требуют точного управления характеристиками сплитератора. В большинстве других случаев, когда требуется сплитератор для массива, следует использовать Arrays.spliterator(Object[]).

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

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

Параметры:

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

additionalCharacteristics — дополнительные характеристики сплитератора для источника или элементов этого сплитератора, помимо SIZED и SUBSIZED, о которых сообщается всегда

Возвращает:

Сплитератор для массива

Исключения:

NullPointerException — если заданный массив равен null

См. также:

spliterator

public static <T> Spliterator<T> spliterator(Object[] array, int fromIndex, int toIndex, int additionalCharacteristics)

Создает Spliterator, охватывающий диапазон элементов заданного массива и использующий настраиваемый набор характеристик сплитератора.

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

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

Параметры:

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

fromIndex — наименьший индекс диапазона (включительно)

toIndex — индекс, следующий за наибольшим индексом диапазона

Возвращает:

Сплитератор для массива

Исключения:

NullPointerException — если заданный массив равен null

ArrayIndexOutOfBoundsException — если fromIndex отрицателен, toIndex меньше fromIndex или toIndex превышает размер массива

См. также:

spliterator

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

Создает Spliterator.OfInt, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.

Параметры:

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

Возвращает:

Сплитератор для массива

Исключения:

NullPointerException — если заданный массив равен null

См. также:

spliterator

public static Spliterator.OfInt spliterator(int[] array, int fromIndex, int toIndex, int additionalCharacteristics)

Создает Spliterator.OfInt, охватывающий диапазон элементов заданного массива и использующий настраиваемый набор характеристик сплитератора.

Параметры:

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

fromIndex — наименьший индекс диапазона (включительно)

toIndex — индекс, следующий за наибольшим индексом диапазона

Возвращает:

Сплитератор для массива

Исключения:

NullPointerException — если заданный массив равен null

ArrayIndexOutOfBoundsException — если fromIndex отрицателен, toIndex меньше fromIndex или toIndex превышает размер массива

См. также:

spliterator

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

Создает Spliterator.OfLong, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.

Параметры:

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

Возвращает:

Сплитератор для массива

Исключения:

NullPointerException — если заданный массив равен null

См. также:

spliterator

public static Spliterator.OfLong spliterator(long[] array, int fromIndex, int toIndex, int additionalCharacteristics)

Создает Spliterator.OfLong, охватывающий диапазон элементов заданного массива и использующий настраиваемый набор характеристик сплитератора.

Возвращенный сплитератор всегда сообщает о характеристиках SIZED и SUBSIZED. Вызывающий код может указать дополнительные характеристики, о которых должен сообщать сплитератор. (Например, если известно, что массив больше не будет изменяться, укажите IMMUTABLE; если считается, что данные массива имеют порядок обхода, укажите ORDERED). Вместо этого часто можно использовать метод Arrays.spliterator(long[], int, int), который возвращает сплитератор, сообщающий о SIZED, SUBSIZED, IMMUTABLE и ORDERED.

Параметры:

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

fromIndex — наименьший индекс диапазона (включительно)

toIndex — индекс, следующий за наибольшим индексом диапазона

Возвращает:

Сплитератор для массива

Исключения:

NullPointerException — если заданный массив равен null

ArrayIndexOutOfBoundsException — если fromIndex отрицателен, toIndex меньше fromIndex или toIndex превышает размер массива

См. также:

spliterator

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

Создает Spliterator.OfDouble, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.

Параметры:

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

Возвращает:

Сплитератор для массива

Исключения:

NullPointerException — если заданный массив равен null

См. также:

spliterator

public static Spliterator.OfDouble spliterator(double[] array, int fromIndex, int toIndex, int additionalCharacteristics)

Создает Spliterator.OfDouble, охватывающий диапазон элементов заданного массива и использующий настраиваемый набор характеристик сплитератора.

Параметры:

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

fromIndex — наименьший индекс диапазона (включительно)

toIndex — индекс, следующий за наибольшим индексом диапазона

Возвращает:

Сплитератор для массива

Исключения:

NullPointerException — если заданный массив равен null

ArrayIndexOutOfBoundsException — если fromIndex отрицателен, toIndex меньше fromIndex или toIndex превышает размер массива

См. также:

spliterator

public static <T> Spliterator<T> spliterator(Collection<? extends T> c, int characteristics)

Создает Spliterator, используя iterator заданной коллекции в качестве источника элементов и сообщая size как начальный размер.

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

Параметры типа:: T — тип элементов
Параметры:: c — коллекция; characteristics — характеристики источника или элементов этого сплитератора. Дополнительно сообщается о характеристиках SIZED и SUBSIZED, если не указан CONCURRENT.
Возвращает:: Сплитератор на основе итератора
Исключения:: NullPointerException — если заданная коллекция равна null

spliterator

public static <T> Spliterator<T> spliterator(Iterator<? extends T> iterator, long size, int characteristics)

Создает Spliterator, используя заданный Iterator в качестве источника элементов и заданный первоначально сообщаемый размер.

Сплитератор не имеет позднего связывания, наследует свойства быстрого обнаружения изменений итератора и реализует trySplit, обеспечивая ограниченный параллелизм.

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

Параметры типа:: T — тип элементов
Параметры:: iterator — итератор источника; size — количество элементов в источнике, которое будет сообщаться как первоначальный estimateSize; characteristics — характеристики источника или элементов этого сплитератора. Дополнительно сообщается о характеристиках SIZED и SUBSIZED, если не указан CONCURRENT.
Возвращает:: Сплитератор на основе итератора
Исключения:: NullPointerException — если заданный итератор равен null

spliteratorUnknownSize

public static <T> Spliterator<T> spliteratorUnknownSize(Iterator<? extends T> iterator, int characteristics)

Создает Spliterator, используя заданный Iterator в качестве источника элементов, без первоначальной оценки размера.

Обход элементов следует выполнять через сплитератор. Поведение разделения и обхода не определено, если после возврата сплитератора выполняются операции с итератором.

Параметры типа:: T — тип элементов
Параметры:: iterator — итератор источника; characteristics — характеристики источника или элементов этого сплитератора (SIZED и SUBSIZED, если указаны, игнорируются и не сообщаются.)
Возвращает:: Сплитератор на основе итератора
Исключения:: NullPointerException — если заданный итератор равен null

spliterator

public static Spliterator.OfInt spliterator(PrimitiveIterator.OfInt iterator, long size, int characteristics)

Создает Spliterator.OfInt, используя заданный IntStream.IntIterator в качестве источника элементов и заданный первоначально сообщаемый размер.

Параметры:: iterator — итератор источника; size — количество элементов в источнике, которое будет сообщаться как первоначальный estimateSize.; characteristics — характеристики источника или элементов этого сплитератора. Дополнительно сообщается о характеристиках SIZED и SUBSIZED, если не указан CONCURRENT.
Возвращает:: Сплитератор на основе итератора
Исключения:: NullPointerException — если заданный итератор равен null

spliteratorUnknownSize

public static Spliterator.OfInt spliteratorUnknownSize(PrimitiveIterator.OfInt iterator, int characteristics)

Создает Spliterator.OfInt, используя заданный IntStream.IntIterator в качестве источника элементов, без первоначальной оценки размера.

Параметры:: iterator — итератор источника; characteristics — характеристики источника или элементов этого сплитератора (SIZED и SUBSIZED, если указаны, игнорируются и не сообщаются.)
Возвращает:: Сплитератор на основе итератора
Исключения:: NullPointerException — если заданный итератор равен null

spliterator

public static Spliterator.OfLong spliterator(PrimitiveIterator.OfLong iterator, long size, int characteristics)

Создает Spliterator.OfLong, используя заданный LongStream.LongIterator в качестве источника элементов и заданный первоначально сообщаемый размер.

Параметры:: iterator — итератор источника; size — количество элементов в источнике, которое будет сообщаться как первоначальный estimateSize.; characteristics — характеристики источника или элементов этого сплитератора. Дополнительно сообщается о характеристиках SIZED и SUBSIZED, если не указан CONCURRENT.
Возвращает:: Сплитератор на основе итератора
Исключения:: NullPointerException — если заданный итератор равен null

spliteratorUnknownSize

public static Spliterator.OfLong spliteratorUnknownSize(PrimitiveIterator.OfLong iterator, int characteristics)

Создает Spliterator.OfLong, используя заданный LongStream.LongIterator в качестве источника элементов, без первоначальной оценки размера.

Параметры:: iterator — итератор источника; characteristics — характеристики источника или элементов этого сплитератора (SIZED и SUBSIZED, если указаны, игнорируются и не сообщаются.)
Возвращает:: Сплитератор на основе итератора
Исключения:: NullPointerException — если заданный итератор равен null

spliterator

public static Spliterator.OfDouble spliterator(PrimitiveIterator.OfDouble iterator, long size, int characteristics)

Создает Spliterator.OfDouble, используя заданный DoubleStream.DoubleIterator в качестве источника элементов и заданный первоначально сообщаемый размер.

Параметры:: iterator — итератор источника; size — количество элементов в источнике, которое будет сообщаться как первоначальный estimateSize; characteristics — характеристики источника или элементов этого сплитератора. Дополнительно сообщается о характеристиках SIZED и SUBSIZED, если не указан CONCURRENT.
Возвращает:: Сплитератор на основе итератора
Исключения:: NullPointerException — если заданный итератор равен null

spliteratorUnknownSize

public static Spliterator.OfDouble spliteratorUnknownSize(PrimitiveIterator.OfDouble iterator, int characteristics)

Создает Spliterator.OfDouble, используя заданный DoubleStream.DoubleIterator в качестве источника элементов, без первоначальной оценки размера.

Параметры:: iterator — итератор источника; characteristics — характеристики источника или элементов этого сплитератора (SIZED и SUBSIZED, если указаны, игнорируются и не сообщаются.)
Возвращает:: Сплитератор на основе итератора
Исключения:: NullPointerException — если заданный итератор равен null

iterator

public static <T> Iterator<T> iterator(Spliterator<? extends T> spliterator)

Создает Iterator из Spliterator.

Обход элементов следует выполнять через итератор. Поведение обхода не определено, если со сплитератором выполняются операции после возврата итератора.

Параметры типа:: T — тип элементов
Параметры:: spliterator — сплитератор
Возвращает:: Итератор
Исключения:: NullPointerException — если заданный сплитератор равен null

iterator

public static PrimitiveIterator.OfInt iterator(Spliterator.OfInt spliterator)

Создает PrimitiveIterator.OfInt из Spliterator.OfInt.

Обход элементов следует выполнять с помощью итератора. Поведение обхода не определено, если сплитератор используется после возврата итератора.

Параметры:: spliterator — сплитератор
Возвращает:: Итератор
Вызывает исключение:: NullPointerException — если указанный сплитератор null

iterator

public static PrimitiveIterator.OfLong iterator(Spliterator.OfLong spliterator)

Создает PrimitiveIterator.OfLong из Spliterator.OfLong.

Параметры:: spliterator — сплитератор
Возвращает:: Итератор
Вызывает исключение:: NullPointerException — если указанный сплитератор null

iterator

public static PrimitiveIterator.OfDouble iterator(Spliterator.OfDouble spliterator)

Создает PrimitiveIterator.OfDouble из Spliterator.OfDouble.

Параметры:: spliterator — сплитератор
Возвращает:: Итератор
Вызывает исключение:: NullPointerException — если указанный сплитератор null

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.