singleWhere 方法

E singleWhere(
  1. bool test(
    1. E element
    ), {
  2. E orElse()?,
})
override

满足 test 条件的单个元素。

检查元素，看 test(element) 是否返回 true。如果正好有一个元素满足 test，则返回该元素。如果找到多个匹配元素，则抛出 StateError。如果没有找到匹配元素，则返回 orElse 的结果。如果省略了 orElse，则默认抛出 StateError。

示例

final numbers = <int>[2, 2, 10];
var result = numbers.singleWhere((element) => element > 5); // 10

如果没有找到匹配元素，则返回调用 orElse 的结果。

result = numbers.singleWhere((element) => element == 1,
    orElse: () => -1); // -1

不能有超过一个匹配元素。

result = numbers.singleWhere((element) => element == 2); // Throws Error.

实现

E singleWhere(bool test(E element), {E Function()? orElse}) {
  int length = this.length;
  late E match;
  bool matchFound = false;
  for (int i = 0; i < length; i++) {
    E element = this[i];
    if (test(element)) {
      if (matchFound) {
        throw IterableElementError.tooMany();
      }
      matchFound = true;
      match = element;
    }
    if (length != this.length) {
      throw ConcurrentModificationError(this);
    }
  }
  if (matchFound) return match;
  if (orElse != null) return orElse();
  throw IterableElementError.noElement();
}