Класс Spliterators.AbstractLongSpliterator

java.lang.Object

java.util.Spliterators.AbstractLongSpliterator

Все реализованные интерфейсы:: Spliterator<Long>, Spliterator.OfLong, Spliterator.OfPrimitive<Long,LongConsumer,Spliterator.OfLong>

Вложенный класс:: Spliterators

public abstract static class Spliterators.AbstractLongSpliterator extends Object implements Spliterator.OfLong

Абстрактный Spliterator.OfLong , реализующий trySplit для ограниченного параллелизма.

Для реализации разделителя, расширяющий класс должен только реализовать tryAdvance. Расширяющий класс должен переопределить forEachRemaining, если он может обеспечить более производительную реализацию.

Примечание API:

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

Альтернативой использованию этого класса, которая также допускает ограниченный параллелизм, является создание разделителя из итератора (см. Spliterators.spliterator(java.util.PrimitiveIterator.OfLong, long, int). В зависимости от обстоятельств, использование итератора может быть проще или удобнее, чем расширение этого класса. Например, если уже доступен итератор, нет необходимости расширять этот класс.

С:

1.8

См. также:

Spliterators.spliterator(java.util.PrimitiveIterator.OfLong, long, int)

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

Вложенные классы/интерфейсы, объявленные в интерфейсе 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

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

AbstractLongSpliterator(long est,
 int additionalCharacteristics)

Модификатор	Конструктор	Описание
`protected`	Создает разделитель, сообщая об указанном предполагаемом размере и характеристиках.

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

Модификатор и тип	Метод	Описание
`int`	`characteristics()`	Возвращает набор характеристик этого разделителя и его элементов.
`long`	`estimateSize()`	Возвращает оценку количества элементов, которые встретятся при обходе `Spliterator.forEachRemaining(java.util.function.Consumer<? super T>)`, или возвращает `Long.MAX_VALUE`, если бесконечно, неизвестно или слишком дорого вычислять.
`Spliterator.OfLong`	`trySplit()`	Если этот разделитель может быть разделен, возвращает Spliterator, охватывающий элементы, которые после возвращения из этого метода не будут охватываться этим разделителем.

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

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

Методы, объявленные в интерфейсе java.util.Spliterator

getComparator, getExactSizeIfKnown, hasCharacteristics

Методы, объявленные в интерфейсе java.util.Spliterator.OfLong

forEachRemaining, tryAdvance

Методы, объявленные в интерфейсе java.util.Spliterator.OfPrimitive

forEachRemaining, tryAdvance

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

AbstractLongSpliterator

protected AbstractLongSpliterator(long est, int additionalCharacteristics)

Создает разделитель, сообщая об указанном предполагаемом размере и характеристиках.

Параметры:: est - предполагаемый размер этого разделителя, если известен, в противном случае Long.MAX_VALUE.; additionalCharacteristics - свойства источника или элементов этого разделителя. Если SIZED указано, этот разделитель дополнительно сообщит SUBSIZED.

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

trySplit

public Spliterator.OfLong trySplit()

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

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

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

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

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

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

estimateSize

public long estimateSize()

Возвращает оценку количества элементов, которые встретятся при обходе Spliterator.forEachRemaining(java.util.function.Consumer<? super T>), или возвращает Long.MAX_VALUE, если бесконечно, неизвестно или слишком дорого вычислять.

Если этот Spliterator Spliterator.SIZED и не был частично пройден или разделен, или этот Spliterator Spliterator.SUBSIZED и не был частично пройден, эта оценка должна быть точным подсчетом элементов, которые встретятся при полном обходе. В противном случае эта оценка может быть произвольно неточной, но должна уменьшаться, как указано при вызовах Spliterator.trySplit().

Указано:: estimateSize в интерфейсе Spliterator<Long>
Требования к реализации:: Эта реализация возвращает предполагаемый размер, как указано при создании, и, если предполагаемый размер известен, уменьшается при разделении.
Возвращает:: оцененный размер или Long.MAX_VALUE , если бесконечно, неизвестно или слишком дорого вычислять.

characteristics

public int characteristics()

Возвращает набор характеристик этого разделителя и его элементов. Результат представлен как ORed значения из Spliterator.ORDERED, Spliterator.DISTINCT, Spliterator.SORTED, Spliterator.SIZED, Spliterator.NONNULL, Spliterator.IMMUTABLE, Spliterator.CONCURRENT, Spliterator.SUBSIZED. Многократные вызовы characteristics() для данного разделителя до или между вызовами trySplit должны всегда возвращать один и тот же результат.

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

Указано:: characteristics в интерфейсе Spliterator<Long>
Требования к реализации:: Эта реализация возвращает характеристики, как указано при создании.
Возвращает:: представление характеристик

© 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.AbstractLongSpliterator.html