iterator 属性
覆盖
一个新的 Iterator
,允许迭代此 Iterable
的元素。
Iterable 类可以指定它们的元素的迭代顺序(例如 List 总是按索引顺序迭代),或者它们可能不指定(例如基于哈希的 Set 可能以任何顺序迭代)。
每次读取 iterator
时,它返回一个新的迭代器,可以用来再次遍历所有元素。同一可迭代的迭代器可以独立地步进,但只要底层集合不被更改,它们应该以相同的顺序返回相同的元素。
修改集合可能会导致新迭代器产生不同的元素,并可能改变现有元素的顺序。一个 List 会精确指定其迭代顺序,因此修改列表会可预测地改变迭代顺序。一个基于哈希的 Set 在向集合添加新元素时可能会完全改变其迭代顺序。
在创建新迭代器后修改底层集合,可能会导致下一次在迭代器的 Iterator.moveNext 上调用时出错。任何 可修改的 可迭代类都应该指定哪些操作会破坏迭代。
实现
@pragma('vm:prefer-inline')
Iterator<E> get iterator => ListIterator<E>(this);