将错误消息写入标准错误而不是标准输出

目前,我们使用 println! 宏将所有输出写入终端。在大多数终端中,有两种类型的输出:标准输出 (stdout) 用于一般信息,标准错误 (stderr) 用于错误消息。这种区别使用户可以选择将程序的成功输出定向到一个文件,但仍然在屏幕上打印错误消息。

println! 宏只能打印到标准输出,因此我们必须使用其他方式来打印到标准错误。

检查错误写入的位置

首先,让我们观察一下 minigrep 打印的内容当前是如何写入标准输出的,包括我们想要写入标准错误的任何错误消息。我们将通过将标准输出流重定向到一个文件,同时故意引起一个错误来做到这一点。我们不会重定向标准错误流,因此发送到标准错误的任何内容将继续显示在屏幕上。

命令行程序应该将错误消息发送到标准错误流,这样即使我们将标准输出流重定向到一个文件,我们仍然可以在屏幕上看到错误消息。我们的程序目前表现不佳:我们即将看到它将错误消息输出保存到一个文件中!

为了演示这种行为,我们将使用 > 和我们想要将标准输出流重定向到的文件路径 output.txt 来运行该程序。我们将不传递任何参数,这应该会导致一个错误。

$ cargo run > output.txt

> 语法告诉 shell 将标准输出的内容写入 output.txt 而不是屏幕。我们没有看到期望的错误消息打印到屏幕上,这意味着它一定最终出现在了文件中。这就是 output.txt 的内容

Problem parsing arguments: not enough arguments

是的,我们的错误消息正在被打印到标准输出。像这样的错误消息打印到标准错误更有用,这样只有成功运行的数据才会最终出现在文件中。我们将改变这一点。

将错误打印到标准错误

我们将使用清单 12-24 中的代码来更改错误消息的打印方式。由于我们在本章前面所做的重构,所有打印错误消息的代码都在一个函数 main 中。标准库提供了 eprintln! 宏,该宏打印到标准错误流,因此让我们将之前调用 println! 来打印错误的两个地方更改为使用 eprintln!

文件名:src/main.rs
use std::env;
use std::process;

use minigrep::Config;

fn main() {
    let args: Vec<String> = env::args().collect();

    let config = Config::build(&args).unwrap_or_else(|err| {
        eprintln!("Problem parsing arguments: {err}");
        process::exit(1);
    });

    if let Err(e) = minigrep::run(config) {
        eprintln!("Application error: {e}");
        process::exit(1);
    }
}
清单 12-24:使用 eprintln! 将错误消息写入标准错误而不是标准输出

现在,让我们以相同的方式再次运行该程序,不带任何参数,并使用 > 重定向标准输出

$ cargo run > output.txt
Problem parsing arguments: not enough arguments

现在我们在屏幕上看到了错误,并且 output.txt 不包含任何内容,这正是我们对命令行程序的期望行为。

让我们再次使用不会导致错误的参数运行该程序,但仍然将标准输出重定向到一个文件,就像这样

$ cargo run -- to poem.txt > output.txt

我们不会在终端上看到任何输出,并且 output.txt 将包含我们的结果

文件名:output.txt

Are you nobody, too?
How dreary to be somebody!

这表明我们现在正在使用标准输出进行成功输出,并根据需要使用标准错误进行错误输出。

总结

本章回顾了你目前学到的一些主要概念,并介绍了如何在 Rust 中执行常见的 I/O 操作。通过使用命令行参数、文件、环境变量和用于打印错误的 eprintln! 宏,你现在已经准备好编写命令行应用程序。结合前面章节的概念,你的代码将组织良好,有效地将数据存储在适当的数据结构中,很好地处理错误,并进行充分的测试。

接下来,我们将探索一些受函数式语言影响的 Rust 特性:闭包和迭代器。