firstWhere 方法
- bool test(
- E value
- {E orElse(
override
返回满足给定谓词 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 value), {E Function()? orElse}) {
for (E element in this) {
if (test(element)) return element;
}
if (orElse != null) return orElse();
throw IterableElementError.noElement();
}