Класс Spliterators

java.lang.Object

java.util.Spliterators

public final class Spliterators extends Object

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

Since:

1.8

See Also:

Spliterator

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

Modifier and Type	Class	Описание
`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` для допуска ограниченного параллелизма.

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

Modifier and Type	Метод	Описание
`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`, используя `Collection.iterator()` заданного объекта коллекции в качестве источника элементов и указывая его `Collection.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 сообщает Spliterator.SIZED и Spliterator.SUBSIZED. Вызовы Spliterator.trySplit() всегда возвращают null.

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

emptyIntSpliterator

public static Spliterator.OfInt emptyIntSpliterator()

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

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

Возвращает:: Пустой spliterator

emptyLongSpliterator

public static Spliterator.OfLong emptyLongSpliterator()

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

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

Возвращает:: Пустой spliterator

emptyDoubleSpliterator

public static Spliterator.OfDouble emptyDoubleSpliterator()

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

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

Возвращает:: Пустой spliterator

spliterator

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

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

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

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

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

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

Параметры:

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

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

Возвращает:

Spliterator для массива

Исключения:

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

См. также:

Arrays.spliterator(Object[])

spliterator

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

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

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

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

Параметры:

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

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

toIndex - На один больше, чем наибольший индекс для охвата

Возвращает:

Spliterator для массива

Исключения:

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

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

См. также:

Arrays.spliterator(Object[], int, int)

spliterator

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

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

Параметры:

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

Возвращает:

Spliterator для массива

Исключения:

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

См. также:

Arrays.spliterator(int[])

spliterator

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

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

Параметры:

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

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

toIndex - На один больше, чем наибольший индекс для охвата

Возвращает:

Spliterator для массива

Исключения:

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

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

См. также:

Arrays.spliterator(int[], int, int)

spliterator

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

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

Параметры:

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

Возвращает:

Spliterator для массива

Исключения:

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

См. также:

Arrays.spliterator(long[])

spliterator

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

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

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

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

Параметры:

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

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

toIndex - Индекс, следующий за наибольшим индексом для покрытия

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

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

Разделитель для массива

Исключения:

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

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

См. также:

Arrays.spliterator(long[], int, int)

spliterator

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

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

Параметры:

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

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

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

Разделитель для массива

Исключения:

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

См. также:

Arrays.spliterator(double[])

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 больше размера массива

См. также:

Arrays.spliterator(double[], int, int)

spliterator

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

Создаёт Spliterator, используя Collection.iterator() заданного набора в качестве источника элементов и сообщая о его Collection.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 в качестве источника элементов без предварительной оценки размера.

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

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

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, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/Spliterators.html