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