dart:collection

Свойство iterator

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

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

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

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

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

Реализация

_DoubleLinkedQueueIterator<E> get iterator {
  return _DoubleLinkedQueueIterator<E>(this);
}