dart:collection

свойство iterator

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

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

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

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

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

Реализация

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