dart:collection

Свойство iterator

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

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

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

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

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

Реализация

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