Spec-Zone.ru › OpenJDK 25

Класс Spliterators

java.lang.Object
java.util.Spliterators
public final class Spliterators extends Object
Статические классы и методы для работы с экземплярами Spliterator и его специализированных примитивных вариантов Spliterator.OfInt, Spliterator.OfLong и Spliterator.OfDouble или их создания.
Начиная с:
1.8
См. также:
  • Spliterator

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

Модификатор и тип Класс Описание
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

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

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[]).

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

Параметры типа:
T — тип элементов
Параметры:
array — массив, который, как предполагается, не будет изменяться во время использования
additionalCharacteristics — дополнительные характеристики сплитератора, относящиеся к источнику или элементам этого сплитератора, помимо SIZED и SUBSIZED, о которых сообщается всегда
Возвращает:
Сплитератор для массива
Вызывает:
NullPointerException — если заданный массив равен null
См. также:
  • Arrays.spliterator(Object[])

spliterator

public static <T> Spliterator<T> spliterator(Object[] array, int fromIndex, int toIndex, int additionalCharacteristics)
Создает Spliterator, охватывающий диапазон элементов заданного массива и использующий настраиваемый набор характеристик сплитератора.

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

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

Параметры типа:
T — тип элементов
Параметры:
array — массив, который, как предполагается, не будет изменяться во время использования
fromIndex — наименьший индекс (включительно) охватываемого диапазона
toIndex — индекс, следующий за наибольшим охватываемым индексом
additionalCharacteristics — дополнительные характеристики сплитератора, относящиеся к источнику или элементам этого сплитератора, помимо SIZED и SUBSIZED, о которых сообщается всегда
Возвращает:
Сплитератор для массива
Вызывает:
NullPointerException — если заданный массив равен null
ArrayIndexOutOfBoundsException — если fromIndex отрицателен, toIndex меньше fromIndex или toIndex превышает размер массива
См. также:
  • Arrays.spliterator(Object[], int, int)

spliterator

public static Spliterator.OfInt spliterator(int[] array, int additionalCharacteristics)
Создает Spliterator.OfInt, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.

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

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

Параметры:
array — массив, который, как предполагается, не будет изменяться во время использования
additionalCharacteristics — дополнительные характеристики сплитератора, относящиеся к источнику или элементам этого сплитератора, помимо SIZED и SUBSIZED, о которых сообщается всегда
Возвращает:
Сплитератор для массива
Вызывает:
NullPointerException — если заданный массив равен null
См. также:
  • Arrays.spliterator(int[])

spliterator

public static Spliterator.OfInt spliterator(int[] array, int fromIndex, int toIndex, int additionalCharacteristics)
Создает Spliterator.OfInt, охватывающий диапазон элементов заданного массива и использующий настраиваемый набор характеристик сплитератора.

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

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

Параметры:
array — массив, который, как предполагается, не будет изменяться во время использования
fromIndex — наименьший индекс (включительно) охватываемого диапазона
toIndex — индекс, следующий за наибольшим охватываемым индексом
additionalCharacteristics — дополнительные характеристики сплитератора, относящиеся к источнику или элементам этого сплитератора, помимо SIZED и SUBSIZED, о которых сообщается всегда
Возвращает:
Сплитератор для массива
Вызывает:
NullPointerException — если заданный массив равен null
ArrayIndexOutOfBoundsException — если fromIndex отрицателен, toIndex меньше fromIndex или toIndex превышает размер массива
См. также:
  • Arrays.spliterator(int[], int, int)

spliterator

public static Spliterator.OfLong spliterator(long[] array, int additionalCharacteristics)
Создает Spliterator.OfLong, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.

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

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

Параметры:
array — массив, который, как предполагается, не будет изменяться во время использования
additionalCharacteristics — дополнительные характеристики сплитератора, относящиеся к источнику или элементам этого сплитератора, помимо SIZED и SUBSIZED, о которых сообщается всегда
Возвращает:
Сплитератор для массива
Вызывает:
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, охватывающий элементы заданного массива и использующий настраиваемый набор характеристик сплитератора.

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

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

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

Этот метод предоставлен для удобства реализации сплитераторов, хранящих части своих элементов в массивах и требующих точного управления характеристиками сплитератора. В большинстве других случаев, когда требуется сплитератор для массива, следует использовать Arrays.spliterator(double[], 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(double[], int, int)

spliterator

public static <T> Spliterator<T> spliterator(Collection<? extends T> c, int characteristics)
Создает Spliterator, используя iterator заданной коллекции в качестве источника элементов и сообщая size коллекции как начальный размер.

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

Сплитератор не имеет отложенной привязки, наследует свойства fail-fast итератора и реализует 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 в качестве источника элементов без первоначальной оценки размера.

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

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

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

spliterator

public static Spliterator.OfInt spliterator(PrimitiveIterator.OfInt iterator, long size, int characteristics)
Создает Spliterator.OfInt, используя заданный IntStream.IntIterator в качестве источника элементов и задавая начальный размер, о котором будет сообщаться.

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

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

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

spliteratorUnknownSize

public static Spliterator.OfInt spliteratorUnknownSize(PrimitiveIterator.OfInt iterator, int characteristics)
Создает Spliterator.OfInt, используя заданный IntStream.IntIterator в качестве источника элементов без первоначальной оценки размера.

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

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

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

spliterator

public static Spliterator.OfLong spliterator(PrimitiveIterator.OfLong iterator, long size, int characteristics)
Создает Spliterator.OfLong, используя заданный LongStream.LongIterator в качестве источника элементов и задавая начальный размер, о котором будет сообщаться.

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

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

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

spliteratorUnknownSize

public static Spliterator.OfLong spliteratorUnknownSize(PrimitiveIterator.OfLong iterator, int characteristics)
Создает Spliterator.OfLong, используя заданный LongStream.LongIterator в качестве источника элементов без первоначальной оценки размера.

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

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

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

spliterator

public static Spliterator.OfDouble spliterator(PrimitiveIterator.OfDouble iterator, long size, int characteristics)
Создает Spliterator.OfDouble, используя заданный DoubleStream.DoubleIterator в качестве источника элементов и задавая начальный размер, о котором будет сообщаться.

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

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

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

spliteratorUnknownSize

public static Spliterator.OfDouble spliteratorUnknownSize(PrimitiveIterator.OfDouble iterator, int characteristics)
Создает Spliterator.OfDouble, используя заданный DoubleStream.DoubleIterator в качестве источника элементов без первоначальной оценки размера.

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

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

Параметры:
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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, где содержатся более подробные описания, ориентированные на разработчиков, с концептуальными обзорами, определениями терминов, обходными решениями и рабочими примерами кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API