dart:collection

свойство iterator

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

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

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

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

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

Исходный код

Iterator<E> get iterator => new _ListQueueIterator<E>(this);