compact1, compact2, compact3

java.util

Класс Spliterators. AbstractSpliterator <T>

java.lang. Объект

java.util.Spliterators.AbstractSpliterator<T>

Все Реализованные Интерфейсы:

Spliterator <T>

Включение class:

Spliterators

public abstract static class Spliterators.AbstractSpliterator<T>
extends Object
implements Spliterator<T>

Краткий обзор Spliterator это реализует trySplit разрешать ограниченный параллелизм.

Расширяющийся class должен только реализовать tryAdvance. Расширяющийся class должен переопределить forEach если это может обеспечить более производительную реализацию.

Примечание API:

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

Альтернатива использованию этого class, который также разрешает ограниченный параллелизм, должна создать spliterator из iterator (см. Spliterators.spliterator(Iterator, long, int). В зависимости от обстоятельств, используя iterator может быть легче или более удобным чем расширение этого class, такой как тогда, когда уже есть iterator доступное использованию.

С тех пор:

1.8

См. Также:

Spliterators.spliterator(Iterator, long, int)

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от интерфейса java.util. Spliterator

Spliterator.OfDouble, Spliterator.OfInt, Spliterator.OfLong

Полевая Сводка

Поля, наследованные от интерфейса java.util. Spliterator

CONCURRENT, DISTINCT, IMMUTABLE, NONNULL, ORDERED, SIZED, SORTED, SUBSIZED

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	Spliterators.AbstractSpliterator(long est, int additionalCharacteristics) Создает spliterator создание отчетов о данном оцененном размере и additionalCharacteristics.

Сводка метода

Модификатор и Тип	Метод и Описание
int	characteristics() Возвраты ряд характеристик этого Spliterator и его элементов.
long	estimateSize() Возвращает оценку числа элементов, с которым встретился бы a Spliterator.forEachRemaining(java.util.function.Consumer<? super T>) обход, или возвраты Long.MAX_VALUE если большое количество, неизвестный, или слишком дорогой, чтобы вычислить.
Spliterator<T>	trySplit() Если этот spliterator может быть разделен, возвращает Spliterator, покрывающий элементы, которые будут по возврату из этого метода, не покрываются этим Spliterator.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, наследованные от интерфейса java.util. Spliterator

forEachRemaining, getComparator, getExactSizeIfKnown, hasCharacteristics, tryAdvance

Деталь конструктора

Spliterators. AbstractSpliterator

protected Spliterators.AbstractSpliterator(long est,
                                           int additionalCharacteristics)

Создает spliterator создание отчетов о данном оцененном размере и additionalCharacteristics.

Параметры:

est - предполагаемый размер этого spliterator если известный, иначе Long.MAX_VALUE.

additionalCharacteristics - свойства источника этого spliterator или элементов. Если SIZED сообщается тогда, этот spliterator дополнительно сообщит SUBSIZED.

Деталь метода

trySplit

public Spliterator<T> trySplit()

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

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

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

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

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

Определенный:

trySplit в интерфейсе Spliterator<T>

Возвраты:

a Spliterator покрытие некоторой части элементов, или null если этот spliterator не может быть разделен

estimateSize

public long estimateSize()

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

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

Определенный:

estimateSize в интерфейсе Spliterator<T>

Требования реализации:

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

Возвраты:

предполагаемый размер, или Long.MAX_VALUE если большое количество, неизвестный, или слишком дорогой, чтобы вычислить.

характеристики

public int characteristics()

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

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

Определенный:

characteristics в интерфейсе Spliterator<T>

Требования реализации:

Эта реализация возвращает характеристики как сообщающийся когда создающийся.

Возвраты:

представление характеристик