迭代属性

迭代器<E> iterator
覆盖

一个新的 Iterator，允许迭代此 Iterable 的元素。

可迭代类可以指定其元素的迭代顺序（例如 List 总是按索引顺序迭代），或者可能不指定（例如基于哈希的 Set 可以按任何顺序迭代）。

每次读取 iterator 时，它都会返回一个新的迭代器，可以用来再次遍历所有元素。相同可迭代的迭代器可以独立地遍历，但只要底层集合未更改，就应该以相同的顺序返回相同的元素。

修改集合可能会使新迭代器产生不同的元素，并可能改变现有元素的顺序。一个 List 指定了其迭代顺序的精确性，因此修改列表会以可预测的方式改变迭代顺序。基于哈希的 Set 在向集合添加新元素时可能会完全改变其迭代顺序。

在创建新迭代器之后修改底层集合可能会在下次对那个迭代器调用 Iterator.moveNext 时导致错误。任何 可修改的 可迭代类都应该指定哪些操作会破坏迭代。

实现

Iterator<E> get iterator {
  // Note: NodeLists are not fixed size. And most probably length shouldn't
  // be cached in both iterator _and_ forEach method. For now caching it
  // for consistency.
  return new FixedSizeListIterator<E>(this);
}