Класс Spliterators.AbstractIntSpliterator

protected AbstractIntSpliterator(long est, int additionalCharacteristics)

Создает сплитератор, сообщающий указанную оценку размера и характеристики.

public Spliterator.OfInt trySplit()

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

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

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

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

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

public long estimateSize()

Возвращает оценку количества элементов, которые будут обработаны при обходе с помощью Spliterator.forEachRemaining(Consumer), или возвращает Long.MAX_VALUE, если количество бесконечно, неизвестно или его вычисление слишком затратно.

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

public int characteristics()

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

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