Класс Spliterators.AbstractIntSpliterator

protected AbstractIntSpliterator(long est, int additionalCharacteristics)

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

public Spliterator.OfInt trySplit()

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

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

За исключением случаев, когда этот итератор охватывает бесконечное количество элементов, повторные вызовы trySplit() должны в конечном итоге вернуть 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.ORDERED, Spliterator.DISTINCT, Spliterator.SORTED, Spliterator.SIZED, Spliterator.NONNULL, Spliterator.IMMUTABLE, Spliterator.CONCURRENT, Spliterator.SUBSIZED. Повторные вызовы characteristics() для данного итератора до или между вызовами trySplit должны всегда возвращать один и тот же результат.

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