dart:collection

Свойство iterator

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

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

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

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

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

Реализация

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