dart:core

Метод 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 toElement(E e)) => MappedIterable<E, T>(this, toElement);