функция Iterable::firstWhere

Возвращает первый элемент коллекции, удовлетворяющий пользовательской функции

Синтаксис

E
Iterable.firstWhere
(bool test(E value), { E orElse() })

Передаваемые параметры

bool test(E value), { E orElse() }

Возвращаемое значение

E

Описание

Метод firstWhere позволяет получить первый элемент коллекции (составного объекта), который удовлетворяет условию, задаваемому пользовательской callback-функции bool test(E value).

В случае, если условию не соответствует ни один элемент, возвращается результат, соответствующий выполнению второго аргумента - пользовательской callback-функции E orElse(), которая, по умолчанию, равняется null.

В случае, если условию не соответствует ни один элемент, и пользовательская callback-функция не задана, будет сгенерирована ошибка типа StateError.

Смотрите также

Iterable::lastWhere - Возвращает последний элемент коллекции, удовлетворяющий пользовательской функции
Iterable::singleWhere - Возвращает элемент, удовлетворяющий пользовательской функции
Iterable::where - Фильтрует элементы коллекции с помощью пользовательской функции

Официальная документация (английский)