Spec-Zone.ru › OpenJDK 8

Интерфейс Spliterator.OfPrimitive<T,T_CONS,T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>

Параметры типа:
T - тип элементов, возвращаемых этим Spliterator. Тип должен быть типом-обёрткой для примитивного типа, например, Integer для примитивного типа int.
T_CONS - тип примитивного потребителя. Тип должен быть примитивной специализацией Consumer для T, например, IntConsumer для Integer.
T_SPLITR - тип примитивного Spliterator. Тип должен быть примитивной специализацией Spliterator для T, например, Spliterator.OfInt для Integer.
Все суперинтерфейсы:
Spliterator<T>
Все известные подинтерфейсы:
Spliterator.OfDouble, Spliterator.OfInt, Spliterator.OfLong
Все известные реализующие классы:
Spliterators.AbstractDoubleSpliterator, Spliterators.AbstractIntSpliterator, Spliterators.AbstractLongSpliterator
Вложенный интерфейс:
Spliterator<T>

public static interface Spliterator.OfPrimitive<T,T_CONS,T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>
extends Spliterator<T>

Spliterator, специализированный для примитивных значений.

С тех пор:
1.8
См. также:
Spliterator.OfInt, Spliterator.OfLong, Spliterator.OfDouble

Вложенные классы

Вложенные классы/интерфейсы, унаследованные от интерфейса java.util.Spliterator

Spliterator.OfDouble, Spliterator.OfInt, Spliterator.OfLong, Spliterator.OfPrimitive<T,T_CONS,T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>

Поля

Поля, унаследованные от интерфейса java.util.Spliterator

CONCURRENT, DISTINCT, IMMUTABLE, NONNULL, ORDERED, SIZED, SORTED, SUBSIZED

Методы

Модификатор и тип Метод и описание
default void forEachRemaining(T_CONS action)

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

boolean tryAdvance(T_CONS action)

Если существует оставшийся элемент, выполняет заданное действие над ним, возвращая true; иначе возвращает false.

T_SPLITR trySplit()

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

Методы, унаследованные от интерфейса java.util.Spliterator

characteristics, estimateSize, forEachRemaining, getComparator, getExactSizeIfKnown, hasCharacteristics, tryAdvance

Методы

trySplit

T_SPLITR trySplit()

Описание скопировано из интерфейса: Spliterator

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

Если этот Spliterator Spliterator.ORDERED, возвращаемый Spliterator должен охватывать строгий префикс элементов.

Если этот Spliterator не охватывает бесконечное число элементов, повторные вызовы trySplit() в конечном итоге должны возвращать null. При ненулевом возврате:

  • значение, указанное для estimateSize() до разделения, должно быть после разделения больше или равно estimateSize() для этого и возвращаемого Spliterator; и
  • если этот Spliterator является SUBSIZED, то estimateSize() для этого spliterator до разделения должно быть равно сумме estimateSize() для этого и возвращаемого Spliterator после разделения.

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

Указано в:
trySplit в интерфейсе Spliterator<T>
Возвращает:
Spliterator, охватывающий часть элементов, или null если этот spliterator не может быть разделен

tryAdvance

boolean tryAdvance(T_CONS action)

Если существует оставшийся элемент, выполняет заданное действие над ним, возвращая true; иначе возвращает false. Если этот Spliterator Spliterator.ORDERED, действие выполняется над следующим элементом в порядке встречи. Исключение, выброшенное действием, передается вызывающей стороне.

Параметры:
action - Действие
Возвращает:
false если на входе в этот метод не существовало оставшихся элементов, иначе true.
Исключения:
NullPointerException - если указанное действие равно null

forEachRemaining

default void forEachRemaining(T_CONS action)

Выполняет заданное действие для каждого оставшегося элемента последовательно в текущем потоке, до тех пор, пока все элементы не будут обработаны или действие не выбросит исключение. Если этот Spliterator Spliterator.ORDERED, действия выполняются в порядке встречи. Исключение, выброшенное действием, передается вызывающей стороне.

Требования к реализации:
Стандартная реализация повторяет вызов tryAdvance(T_CONS) до тех пор, пока он не вернёт false. Она должна быть переопределена всякий раз, когда это возможно.
Параметры:
action - Действие
Исключения:
NullPointerException - если указанное действие равно null

© 1993, 2020, 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.

Spec-Zone.ru

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