dart:collection

метод singleWhere

Возвращает единственный элемент, удовлетворяющий 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}) {
  late E result;
  bool foundMatching = false;
  for (E element in this) {
    if (test(element)) {
      if (foundMatching) {
        throw IterableElementError.tooMany();
      }
      result = element;
      foundMatching = true;
    }
  }
  if (foundMatching) return result;
  if (orElse != null) return orElse();
  throw IterableElementError.noElement();
}