firstWhere 方法

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

    返回给定谓词 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();
    }