Класс 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` в качестве источника элементов без оценки начального размера.

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

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

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

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, охватывающий элементы заданного массива, используя настраиваемый набор характеристик сплитератора.

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

Возвращаемый сплитератор всегда сообщает характеристики SIZED и SUBSIZED. Вызывающий абонент может указать дополнительные характеристики для возвращаемого сплитератора; обычно дополнительно указываются IMMUTABLE и ORDERED.

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

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, охватывающий диапазон элементов заданного массива, используя настроенный набор характеристик spliterator.

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

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

Параметры:

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

fromIndex - Наименьший индекс (включительно) для покрытия

toIndex - Один за наибольшим индексом для покрытия

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

Возвращает:

Spliterator для массива

Исключения:

NullPointerException - если заданный массив является null

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

См. также:

spliterator

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

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

Возвращаемый spliterator всегда сообщает о характеристиках SIZED и SUBSIZED. Вызывающая сторона может предоставить дополнительные характеристики для spliterator; обычно дополнительно указываются IMMUTABLE и ORDERED.

Параметры:

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

Возвращает:

Spliterator для массива

Исключения:

NullPointerException - если заданный массив является null

См. также:

spliterator

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

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

Параметры:

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

fromIndex - Наименьший индекс (включительно) для покрытия

toIndex - Один за наибольшим индексом для покрытия

Возвращает:

Spliterator для массива

Исключения:

NullPointerException - если заданный массив является null

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

См. также:

spliterator

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

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

Spliterator является отложенно-связанным, наследует свойства fail-fast итератора коллекции и реализует trySplit для разрешения ограниченного параллелизма.

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

spliterator

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

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

Spliterator не является отложенно-связанным, наследует свойства fail-fast итератора и реализует trySplit для разрешения ограниченного параллелизма.

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

Параметры типа:: T - Тип элементов
Параметры:: iterator - Итератор для источника; size - Количество элементов в источнике, которые должны быть указаны как начальный estimateSize; characteristics - Характеристики источника или элементов этого spliterator. Характеристики SIZED и SUBSIZED дополнительно сообщаются, если CONCURRENT не указан.
Возвращает:: Spliterator из итератора
Исключения:: NullPointerException - если заданный итератор является null

spliteratorUnknownSize

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

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

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

spliterator

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

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

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

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

Parameters:: iterator - Итератор для источника; size - Количество элементов в источнике, которое будет указано как начальный estimateSize.; characteristics - Характеристики источника или элементов этого разделителя. Характеристики SIZED и SUBSIZED дополнительно сообщаются, если CONCURRENT не предоставлен.
Returns:: Разделитель от итератора
Throws:: NullPointerException - если данный итератор является null

spliteratorUnknownSize

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

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

Parameters:: iterator - Итератор для источника; characteristics - Характеристики источника или элементов этого разделителя (SIZED и SUBSIZED, если предоставлены, игнорируются и не сообщаются).
Returns:: Разделитель от итератора
Throws:: NullPointerException - если данный итератор является null

spliterator

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

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

Parameters:: iterator - Итератор для источника; size - Количество элементов в источнике, которое будет указано как начальный estimateSize.; characteristics - Характеристики источника или элементов этого разделителя. Характеристики SIZED и SUBSIZED дополнительно сообщаются, если CONCURRENT не предоставлен.
Returns:: Разделитель от итератора
Throws:: NullPointerException - если данный итератор является null

spliteratorUnknownSize

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

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

Parameters:: iterator - Итератор для источника; characteristics - Характеристики источника или элементов этого разделителя (SIZED и SUBSIZED, если предоставлены, игнорируются и не сообщаются).
Returns:: Разделитель от итератора
Throws:: NullPointerException - если данный итератор является null

spliterator

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

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

Parameters:: iterator - Итератор для источника; size - Количество элементов в источнике, которое будет указано как начальный estimateSize; characteristics - Характеристики источника или элементов этого разделителя. Характеристики SIZED и SUBSIZED дополнительно сообщаются, если CONCURRENT не предоставлен.
Returns:: Разделитель от итератора
Throws:: NullPointerException - если данный итератор является null

spliteratorUnknownSize

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

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

Parameters:: iterator - Итератор для источника; characteristics - Характеристики источника или элементов этого разделителя (SIZED и SUBSIZED, если предоставлены, игнорируются и не сообщаются).
Returns:: Разделитель от итератора
Throws:: NullPointerException - если данный итератор является null

iterator

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

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

Обработка элементов должна выполняться через итератор. Поведение обработки не определено, если на разделитель оказывается воздействие после возврата итератора.

Type Parameters:: T - Тип элементов
Parameters:: spliterator - Разделитель
Returns:: Итератор
Throws:: NullPointerException - если данный разделитель является null

iterator

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

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

Parameters:: spliterator - Разделитель
Returns:: Итератор
Throws:: NullPointerException - если данный разделитель является null

iterator

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

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

Parameters:: spliterator - Разделитель
Returns:: Итератор
Throws:: NullPointerException - если данный разделитель является null

iterator

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

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

Parameters:: spliterator - Разделитель
Returns:: Итератор
Throws:: 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/Spliterators.html