Класс Spliterators.AbstractDoubleSpliterator

java.lang.Object
- java.util.Spliterators.AbstractDoubleSpliterator

Все реализованные интерфейсы:: Spliterator<Double>, Spliterator.OfDouble, Spliterator.OfPrimitive<Double,DoubleConsumer,Spliterator.OfDouble>

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

public abstract static class Spliterators.AbstractDoubleSpliterator
extends Object
implements Spliterator.OfDouble

Абстрактный Spliterator.OfDouble для реализации trySplit, что позволяет ограниченную параллельность.

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

Примечание API:: Этот класс является полезным инструментом для создания разделителя, когда невозможно или сложно эффективно разделить элементы таким образом, чтобы позволить сбалансированное параллельное вычисление.
Альтернативой использованию этого класса, которая также допускает ограниченную параллельность, является создание разделителя из итератора (см. Spliterators.spliterator(java.util.PrimitiveIterator.OfDouble, long, int). В зависимости от обстоятельств, использование итератора может быть проще или удобнее, чем расширение этого класса. Например, если уже доступен итератор, то нет необходимости расширять этот класс.
С:: 1.8
См. также:: Spliterators.spliterator(java.util.PrimitiveIterator.OfDouble, 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

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

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

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

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

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

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

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

getComparator, getExactSizeIfKnown, hasCharacteristics

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

forEachRemaining, tryAdvance

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

forEachRemaining, tryAdvance

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

AbstractDoubleSpliterator

protected AbstractDoubleSpliterator(long est,
                                    int additionalCharacteristics)

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

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

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

trySplit

public Spliterator.OfDouble trySplit()

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

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

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

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

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

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

estimateSize

public long estimateSize()

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

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

Указано в:: estimateSize в интерфейсе Spliterator<Double>
Требования к реализации:: Эта реализация возвращает предполагаемый размер, как указано при создании, и, если размер известен, уменьшается при разделении.
Возвращает:: предполагаемый размер, или 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<Double>
Требования к реализации:: Эта реализация возвращает характеристики, как указано при создании.
Возвращает:: представление характеристик