firstWhere 方法
- bool test(
- E element
- {E orElse(
inherited
返回给定谓词 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 element), {E Function()? orElse}) {
int length = this.length;
for (int i = 0; i < length; i++) {
E element = elementAt(i);
if (test(element)) return element;
if (length != this.length) {
throw ConcurrentModificationError(this);
}
}
if (orElse != null) return orElse();
throw IterableElementError.noElement();
}