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" 不会被处理,因为第三项已经失败。

rust
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}"),
    }
}

预期输出

text
解析 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 的短路语义替你提前结束遍历。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

迭代器如何收集 Result 序列

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通