dart:collection

Метод map<T>

Текущие элементы этого итерируемого объекта, изменённые с помощью toElement.

Возвращает новый ленивый Iterable с элементами, которые создаются путём вызова toElement для каждого элемента этого Iterable в порядке итерации.

Возвращаемый итерируемый объект является ленивым, поэтому он не будет итерировать элементы этого итерируемого объекта до тех пор, пока сам не будет итерироваться, а затем он будет применять toElement для создания одного элемента за раз. Преобразованные элементы не кэшируются. Многократная итерация по возвращаемому Iterable вызовет предоставленную toElement функцию один раз на элемент при каждой итерации.

Методы возвращаемого итерируемого объекта могут опустить вызов toElement для любого элемента, где результат не требуется. Например, elementAt может вызвать toElement только один раз.

Эквивалентно:

Iterable<T> map<T>(T toElement(E e)) sync* {
  for (var value in this) {
    yield toElement(value);
  }
}

Пример:

var products = jsonDecode('''
[
  {"name": "Screwdriver", "price": 42.00},
  {"name": "Wingnut", "price": 0.50}
]
''');
var values = products.map((product) => product['price'] as double);
var totalPrice = values.fold(0.0, (a, b) => a + b); // 42.5.

Реализация

Iterable<T> map<T>(T f(E element)) => MappedListIterable<E, T>(this, f);