Интерфейс PrimitiveIterator<T,T_CONS>
- Параметры типа:
-
T— тип элементов, возвращаемых этим PrimitiveIterator. Тип должен быть обертывающим типом для примитивного типа, например,Integerдля примитивного типаint. -
T_CONS— тип примитивного потребителя. Тип должен быть примитивным специализациейConsumerдляT, например,IntConsumerдляInteger.
- Все суперинтерфейсы:
Iterator<T>
- Все известные подинтерфейсы:
-
PrimitiveIterator.OfDouble,PrimitiveIterator.OfInt,PrimitiveIterator.OfLong
public interface PrimitiveIterator<T,T_CONS> extends Iterator<T>
Базовый тип для примитивных специализаций Iterator. Специализированные подтипы предоставляются для int, long и double значений.
Специализированные подтипы по умолчанию реализуют Iterator.next() и Iterator.forEachRemaining(java.util.function.Consumer) для упаковки примитивных значений в экземпляры соответствующего обертывающего класса. Такая упаковка может компенсировать любые преимущества, полученные при использовании примитивных специализаций. Для избежания упаковки следует использовать соответствующие методы на основе примитивов. Например, PrimitiveIterator.OfInt.nextInt() и PrimitiveIterator.OfInt.forEachRemaining(java.util.function.IntConsumer) следует использовать вместо PrimitiveIterator.OfInt.next() и PrimitiveIterator.OfInt.forEachRemaining(java.util.function.Consumer).
Итерация примитивных значений с помощью методов упаковки на основе next() и forEachRemaining() не влияет на порядок, в котором встречаются значения, преобразованные в упакованные значения.
- Примечание об реализации:
- Если системная переменная
org.openjdk.java.util.stream.tripwireустановлена вtrue, то будут выводиться диагностические предупреждения, если происходит упаковка примитивных значений при работе с примитивными специализированными подтипами. - С:
- 1.8
Вложенные классы
| Модификатор и тип | Интерфейс | Описание |
|---|---|---|
static interface |
PrimitiveIterator.OfDouble |
Итератор, специализированный для значений |
static interface |
PrimitiveIterator.OfInt |
Итератор, специализированный для значений |
static interface |
PrimitiveIterator.OfLong |
Итератор, специализированный для значений |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
forEachRemaining(T_CONS action) |
Выполняет заданное действие для каждого оставшегося элемента в порядке их появления во время итерации, до обработки всех элементов или возникновения исключения в результате действия. |
Методы, объявленные в интерфейсе java.util.Iterator
forEachRemaining, hasNext, next, remove
Методы
forEachRemaining
void forEachRemaining(T_CONS action)
Выполняет заданное действие для каждого оставшегося элемента в порядке их появления во время итерации, до обработки всех элементов или возникновения исключения в результате действия. Ошибки или исключения времени выполнения, сгенерированные действием, передаются вызывающей стороне.
- Параметры:
-
action— действие, выполняемое для каждого элемента - Исключения:
-
NullPointerException— если указанное действие равно null
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/PrimitiveIterator.html
