dart:core

Свойство iterator

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

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

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

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

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

Исходный код

Iterator<E> get iterator;