用于从对象中逐个获取项的接口。
for-in 构造使用 Iterator
透明地测试迭代结束,以及获取每个项(或元素)。
如果在迭代过程中修改了迭代的对象,行为是未指定的。
Iterator
初始位置在第一个元素之前。因此,在访问第一个元素之前必须使用 moveNext 将迭代器向前移动以指向第一个元素。如果没有剩余元素,则 moveNext 返回 false,并且对 moveNext 的所有进一步调用也将返回 false。
在调用 moveNext 或返回 false 之后,不允许访问 moveNext 的当前值。
一个典型使用的 Iterator
示例如下
var it = obj.iterator;
while (it.moveNext()) {
use(it.current);
}
另请参阅: 库之旅中的迭代
构造函数
- Iterator()
属性
- current → E
- 当前元素。没有设置器
- hashCode → int
- 此对象的哈希码。没有设置器继承
- runtimeType → Type
- 表示对象运行时类型的表示。没有设置器继承
方法
-
moveNext(
) → bool - 将迭代器前进到迭代的下一个元素。
-
noSuchMethod(
Invocation invocation) → dynamic - 当访问不存在的方法或属性时被调用。继承
-
toString(
) → String - 此对象的字符串表示。继承
运算符
-
operator ==(
Object other) → bool - 等价运算符。继承