Свойство iterator
Iterator<E> iteratorВозвращает новый Iterator, который позволяет перебирать элементы этого Iterable.
Классы Iterable могут указать порядок перебора элементов (например, List всегда перебирают элементы в порядке индексов), или они могут его не указывать (например, хэш-табличный Set может перебирать элементы в произвольном порядке).
Каждый раз, когда вы iterator , он возвращает новый итератор, который можно использовать для повторного перебора всех элементов. Итераторы одного и того же Iterable могут продвигаться независимо, но должны возвращать те же элементы в том же порядке, пока базовое хранилище данных не будет изменено.
Изменение коллекции может привести к тому, что новые итераторы будут генерировать разные элементы и могут изменить порядок существующих элементов. List точно определяет свой порядок перебора, поэтому изменение списка предсказуемо изменяет порядок перебора. Хэш-табличный Set может полностью изменить свой порядок перебора при добавлении нового элемента в множество.
Изменение базового хранилища данных после создания нового итератора может привести к ошибке при следующем вызове Iterator.moveNext для этого итератора. Любой изменяемый класс Iterable должен указывать, какие операции нарушат итерацию.
Исходный код
Iterator<E> get iterator => new _LinkedListIterator<E>(this);
© 2012 the Dart project authors
Licensed under the Creative Commons Attribution-ShareAlike License v4.0.
https://api.dartlang.org/stable/1.24.3/dart-collection/LinkedList/iterator.html