singleWhere 方法

String singleWhere(
  1. bool test(
    1. String value
    ), {
  2. String 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.

实现

String singleWhere(bool test(String value), {String orElse()?}) =>
    readClasses().singleWhere(test, orElse: orElse);