dart:collection

свойство iterator

Возвращает новый Iterator, позволяющий перебирать элементы этого Iterable.

Классы Iterable могут задавать порядок перебора своих элементов (например, List всегда перебирает элементы в порядке индексов) или не задавать его (например, хеш-основанный Set может перебирать элементы в любом порядке).

При каждом чтении iterator возвращается новый итератор, который можно использовать для повторного перебора всех элементов. Итераторы одного и того же итерируемого объекта можно перемещать независимо друг от друга, но они должны возвращать одни и те же элементы в одном и том же порядке, пока базовая коллекция не изменяется.

Изменение коллекции может привести к тому, что новые итераторы будут возвращать другие элементы, а порядок существующих элементов может измениться. List точно задаёт порядок перебора, поэтому изменение списка предсказуемо меняет этот порядок. Хеш-основанный Set может полностью изменить порядок перебора при добавлении нового элемента в набор.

Изменение базовой коллекции после создания нового итератора может привести к ошибке при следующем вызове Iterator.moveNext для этого итератора. Любой изменяемый итерируемый класс должен указывать, какие операции прерывают перебор.

Реализация

Iterator<E> get iterator => ListIterator<E>(this);