Rust / 系统课时

map 与 map_err 改写结果

map 与 map_err 改写结果

处理 Result 时,并不是每次都需要展开 match。当需求只是修改成功值,或者把错误换成另一种表示时,map 与 map_err 可以只处理对应的一侧,并原样保留另一侧,让错误处理链更短也更容易阅读。

学习目标

  • 区分 map 与 map_err 分别作用于 Ok 和 Err 的规则
  • 使用链式调用转换成功值和错误值
  • 识别应使用 map、map_err 或 and_then 的边界

两个方法各改一侧

对于 Result<T, E>,map 接收一个处理成功值的闭包,把 T 转换成另一种成功类型;如果当前已经是 Err,闭包不会执行,错误会直接保留下来。

map_err 正好相反:它只处理 Err 中的错误,把错误类型或错误内容转换掉;如果当前是 Ok,成功值保持不变。

方法 执行闭包的情况 保持不变的一侧 常见用途
map Ok(value) Err(error) 格式化、计算或包装成功值
map_err Err(error) Ok(value) 统一错误类型、补充错误语义

这两个方法都消费当前 Result 并产生新的 Result,因此很适合直接接在解析、读取或调用结果后继续组成链式表达式。

在同一条链上改写成功和失败

下面的程序先把字符串解析成 u32,成功后将数字乘以二;解析失败时,则把标准库的解析错误改写成当前函数使用的 String 错误。

rust
fn parse_and_double(input: &str) -> Result<u32, String> {
    input
        .parse::<u32>()
        // 只有解析成功时才执行计算。
        .map(|value| value * 2)
        // 只有解析失败时才把错误改成当前函数需要的类型。
        .map_err(|_| "input is not a u32".to_string())
}

fn main() {
    println!("{:?}", parse_and_double("21"));
    println!("{:?}", parse_and_double("abc"));
}

预期输出

text
Ok(42)
Err("input is not a u32")

输入 21 时,解析得到 Ok(21),因此 map 执行并得到 Ok(42),后面的 map_err 不会调用闭包。输入 abc 时,解析直接得到 Err,所以 map 被跳过,只有 map_err 执行。

为什么比 match 更适合局部转换

如果只是对 Result 的一侧做简单变换,写完整 match 会同时展开成功和失败两个分支,即使其中一个分支只是原样返回。map 和 map_err 把这种机械代码收起,使读者可以直接看到真正发生的转换。

它们尤其适合紧邻错误产生位置使用。例如底层库返回自己的错误类型,而当前模块只需要映射成模块级错误时,可以先 map_err,随后继续 ? 传播;成功值需要包装成 DTO 或执行纯计算时,则可以使用 map。

不要把 map_err 当成万能错误处理

map_err 最适合真正改变错误类型或错误语义。如果错误需要根据多个上下文分支决定如何处理,或者需要恢复、重试、回退到默认值,显式 match 往往更清楚。

同样,map 只负责转换成功值,并不会处理失败恢复。看到一条较长的调用链时,可以按一个简单规则阅读:map 追踪成功路径上的值如何变化,map_err 追踪失败路径上的错误如何变化。只要两条路径的职责保持单一,链式写法就能在紧凑和可读性之间取得较好的平衡。

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

目录与阅读设置

阅读设置

17

记录一个想法

map 与 map_err 改写结果

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

登录哪都通