firstWhere 方法

E firstWhere(
  1. bool test(
    1. E value
    ), {
  2. E orElse()?,
})
override

返回满足给定谓词 test 的第一个元素。

遍历元素并返回第一个满足 test 的元素。

示例

final numbers = <int>[1, 2, 3, 5, 6, 7];
var result = numbers.firstWhere((element) => element < 5); // 1
result = numbers.firstWhere((element) => element > 5); // 6
result =
    numbers.firstWhere((element) => element > 10, orElse: () => -1); // -1

如果没有任何元素满足 test，则返回调用 orElse 函数的结果。如果省略 orElse，则默认抛出 StateError。在找到第一个匹配元素时停止遍历。

实现

E firstWhere(bool test(E value), {E Function()? orElse}) {
  for (E element in this) {
    if (test(element)) return element;
  }
  if (orElse != null) return orElse();
  throw IterableElementError.noElement();
}