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)) =>
    EfficientLengthMappedIterable<E, T>(this, f);