Класс Spliterators.AbstractDoubleSpliterator

protected AbstractDoubleSpliterator(long est, int additionalCharacteristics)

Создаёт итератор с заданным приблизительным размером и характеристиками.

public Spliterator.OfDouble trySplit()

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

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

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

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

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

public long estimateSize()

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

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

public int characteristics()

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

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