singleWhere 方法

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

满足 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 orElse()?}) {
  var iterator = this.iterator;
  E result;
  do {
    if (!iterator.moveNext()) {
      if (orElse != null) return orElse();
      throw IterableElementError.noElement();
    }
    result = iterator.current;
  } while (!test(result));
  while (iterator.moveNext()) {
    if (test(iterator.current)) throw IterableElementError.tooMany();
  }
  return result;
}