Класс Spliterators.AbstractDoubleSpliterator

protected AbstractDoubleSpliterator(long est, int additionalCharacteristics)

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

public Spliterator.OfDouble trySplit()

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

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

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

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

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

public long estimateSize()

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

Если этот сплитератор имеет характеристику Spliterator.SIZED и обход или разделение еще не выполнялись частично либо этот сплитератор имеет характеристику 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 или между ними всегда должны возвращать один и тот же результат.

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