Returns the first element that satisfies the given predicate test
.
Iterates through elements and returns the first to satisfy test
.
If no element satisfies test
, the result of invoking the orElse
function is returned.
If orElse
is omitted, it defaults to throwing a StateError
.
Source
E firstWhere(bool test(E value), { E orElse() }) {
for (E element in this) {
if (test(element)) return element;
}
if (orElse != null) return orElse();
throw IterableElementError.noElement();
}