Spec-Zone.ru › Dart 1

dart:core

Свойство 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API