一个用于一次一个、从对象获取元素的接口。

for-in结构以透明的方式使用Iterator测试迭代是否结束,并获取每个item(或 element)。

如果迭代的对象在迭代过程中发生变化,则该行为是未指定的。

最开始,Iterator指向第一个元素的位置前面。 因此在访问第一个元素前,迭代器必须提前使用moveNext指向第一个元素。 如果指向末尾,之后已经没有元素,moveNext将返回false,current返回null, 并且再调用moveNext也将放回false。

下面是迭代器的典型用法:

var it = obj.iterator;
while (it.moveNext()) {
  use(it.current);
}

参见: library tour 中的 Iteration 章节。

Implemented by

Constructors

Iterator()

Properties

current → E

返回当前元素。

read-only
hashCode int

获取对象的哈希值。

read-only, inherited
runtimeType Type

表示对象的运行时类型。

read-only, inherited

Operators

operator ==(other) bool

相等操作符。

inherited

Methods

moveNext() bool

移动到下一个元素。

noSuchMethod(Invocation invocation) → dynamic

当一个不存在的函数或成员变量被访问时,该函数被调用。

inherited
toString() String

返回一个用来表示对象的字符串。

inherited