模块 java.base

软件包 java.util

Interface PrimitiveIterator<T,T_CONS>

参数类型

T - 此PrimitiveIterator返回的元素类型。 该类型必须是对一个原始类型的包装类型，例如Integer为原始int类型。

T_CONS - 原始消费者的类型。 对于T ，类型必须是Consumer的原始T ，例如IntConsumer （ Integer 。

All Superinterfaces:

Iterator<T>

All Known Subinterfaces:

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()迭代原始值不会影响遇到转换为盒装值的值的顺序。

Implementation Note:

如果布尔系统属性 org.openjdk.java.util.stream.tripwire设置为 true则在对原始子类型特化进行操作时，如果出现原始值的装箱，则会报告诊断警告。

从以下版本开始：

1.8

嵌套类汇总

嵌套类

变量和类型	接口	描述
static interface	PrimitiveIterator.OfDouble	迭代器专门用于 double值。
static interface	PrimitiveIterator.OfInt	一个专门用于 int值的迭代器。
static interface	PrimitiveIterator.OfLong	一个专门用于 long值的迭代器。

方法摘要

变量和类型	方法	描述
void	forEachRemaining(T_CONS action)	对每个剩余元素执行给定操作，迭代时出现顺序元素，直到处理完所有元素或操作抛出异常。

声明方法的接口 java.util.Iterator

forEachRemaining, hasNext, next, remove

方法详细信息

forEachRemaining

void forEachRemaining(T_CONS action)

对每个剩余元素执行给定操作，迭代时出现顺序元素，直到处理完所有元素或操作抛出异常。 操作引发的错误或运行时异常将中继到调用方。

参数

action - 要为每个元素执行的操作

异常

NullPointerException - 如果指定的操作为null