Библиотеки » Основная библиотека (dart:core) » Iterable » firstWhere
функция 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 - Фильтрует элементы коллекции с помощью пользовательской функции