Rust / 系统课时
迭代器如何收集 Result 序列
迭代器如何收集 Result 序列
批量解析配置、读取多条输入或逐项校验时,迭代器里的每一项都可能失败。Rust 可以把 Iterator<Item = Result<T, E>> 直接收集成一个 Result<Vec<T>, E>:全部成功才得到集合,遇到第一个错误就立即停止。
学习目标
- 掌握把一串
Result收集为整体Result的写法 - 理解
collect在遇到第一个Err时为何会短路 - 能区分“全部成功才继续”和“保留每一项结果”两种需求
collect 如何改变结果形状
普通迭代器常见的是把若干 T 收集成 Vec<T>。当元素本身是 Result<T, E> 时,只要目标类型写成 Result<Vec<T>, E>,collect 就会按 Result 的实现规则工作。
这会把“很多个局部结果”转换成“一个整体结果”:所有元素都是 Ok 时返回 Ok(Vec<T>);一旦出现 Err,立即返回该错误,后面的元素不再处理。
观察遇错即停
下面的程序在解析每个字符串前打印一次日志。输入中的第四项 "40" 不会被处理,因为第三项已经失败。
fn parse_numbers(inputs: &[&str]) -> Result<Vec<i32>, String> {
inputs
.iter()
.map(|raw| {
println!("解析 {raw}");
raw.parse::<i32>()
.map_err(|_| format!("无法解析 {raw}"))
})
.collect()
}
fn main() {
let inputs = ["10", "20", "oops", "40"];
match parse_numbers(&inputs) {
Ok(values) => println!("成功: {values:?}"),
Err(error) => println!("失败: {error}"),
}
}预期输出
解析 10
解析 20
解析 oops
失败: 无法解析 oops这个行为不是 map 提前停止,而是最终的 collect 在消费迭代器时发现 Err,于是结束收集并返回该错误。
类型标注放在哪里
编译器必须知道你想收集成哪一种容器。返回类型已经声明为 Result<Vec<i32>, String> 时,示例中的 collect() 可以靠上下文推断。如果上下文不够明确,也可以写成 collect::<Result<Vec<_>, _>>()。
成功时,Vec 会保持原迭代顺序;失败时,只能得到第一个遇到的错误。因此这种方式适合“任一项失败,整个批次都不能继续”的场景,例如读取一组必须全部合法的端口号或配置值。
需要所有错误时不要短路
有些校验任务需要一次向用户展示全部错误,此时直接收集成 Result<Vec<_>, _> 并不合适,因为它只保留第一个失败。可以先收集为 Vec<Result<T, E>>,再分别整理成功项和错误项,或者使用专门的验证结构累积错误。
判断方式很简单:如果业务语义是“全部成功才有意义”,用 collect 得到整体 Result;如果业务语义是“每一项的结果都要保留”,就不要让 Result 的短路语义替你提前结束遍历。