compact1, compact2, compact3

java.util

Interface Iterator<E>

参数类型

E - 此迭代器返回的元素的类型

All Known Subinterfaces:

ListIterator <E>， PrimitiveIterator <T，T_CONS>， PrimitiveIterator.OfDouble ， PrimitiveIterator.OfInt ， PrimitiveIterator.OfLong ， XMLEventReader

所有已知实现类：

BeanContextSupport.BCSIterator ， EventReaderDelegate ， Scanner

public interface Iterator<E>

一个集合的迭代器。 Iterator需要的地方Enumeration在Java集合框架。 迭代器有两种不同的枚举方式：

• 迭代器允许调用者在迭代期间从底层集合中删除元素，并具有明确定义的语义。
• 方法名称得到改进。

此接口是成员Java Collections Framework 。

从以下版本开始：

1.2

另请参见：

Collection ， ListIterator ， Iterable

方法摘要

Modifier and Type	Method and Description
default void	forEachRemaining(Consumer<? super E> action) 对每个剩余元素执行给定的操作，直到所有元素都被处理或动作引发异常。
boolean	hasNext() 如果迭代具有更多元素，则返回 true 。
E	next() 返回迭代中的下一个元素。
default void	remove() 从底层集合中删除此迭代器返回的最后一个元素（可选操作）。

方法详细信息

hasNext

boolean hasNext()

如果迭代具有更多的元素，则返回true 。 （换句话说，如果next()返回一个元素而不是抛出一个异常，则返回true ）

结果

true如果迭代有更多的元素

next

E next()

返回迭代中的下一个元素。

结果

迭代中的下一个元素

异常

NoSuchElementException - 如果迭代没有更多的元素

remove

default void remove()

从底层集合中删除此迭代器返回的最后一个元素（可选操作）。 此方法只能调用一次next() 。 如果底层集合在迭代过程中以任何方式进行修改而不是通过调用此方法，则迭代器的行为是未指定的。

实现要求：

默认的实现抛出的一个实例UnsupportedOperationException并执行其他操作。

异常

UnsupportedOperationException -如果 remove操作不会被这个迭代器支持

IllegalStateException - 如果 next方法尚未被调用，或者 remove方法在上次调用 next方法之后已经被调用

forEachRemaining

default void forEachRemaining(Consumer<? super E> action)

对每个剩余元素执行给定的操作，直到所有元素都被处理或动作引发异常。 如果指定了该顺序，则按迭代的顺序执行操作。 动作抛出的异常被转发给呼叫者。

实现要求：

默认实现的行为如下：

   while (hasNext()) action.accept(next());  

参数

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

异常

NullPointerException - 如果指定的动作为空

从以下版本开始：

1.8