firstWhere 方法

E firstWhere(
  1. bool test(
    1. E element
    ), {
  2. E orElse()?,
})
继承

返回第一个满足给定谓词 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 element), {E Function()? orElse}) {
  int length = this.length;
  for (int i = 0; i < length; i++) {
    E element = elementAt(i);
    if (test(element)) return element;
    if (length != this.length) {
      throw ConcurrentModificationError(this);
    }
  }
  if (orElse != null) return orElse();
  throw IterableElementError.noElement();
}