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 错误。
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"));
}预期输出
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 追踪失败路径上的错误如何变化。只要两条路径的职责保持单一,链式写法就能在紧凑和可读性之间取得较好的平衡。