Класс Spliterators.AbstractLongSpliterator

protected AbstractLongSpliterator(long est, int additionalCharacteristics)

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

public Spliterator.OfLong 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.