Метод map<T>
Iterable<T> map<T>(Возвращает новый ленивый Iterable с элементами, созданными путем вызова f для каждого элемента этого Iterable в порядке итерации.
Этот метод возвращает представление преобразованных элементов. Пока возвращаемый Iterable не итерируется, предоставленная функция f не будет вызвана. Преобразованные элементы не кэшируются. Многократная итерация над возвращаемым Iterable вызовет предоставленную функцию f несколько раз для одного и того же элемента.
Методы возвращаемого итерируемого объекта могут опустить вызов f для любого элемента, где результат не требуется. Например, elementAt может вызвать f только один раз.
Исходный код
Iterable<T> map<T>(T f(E e)) => new MappedIterable<E, T>(this, f);
© 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/Iterable/map.html