Сообщения об ошибках Rust в стандартный вывод ошибок

Введение

Добро пожаловать в Запись сообщений об ошибках в стандартный вывод ошибок вместо стандартного вывода. Эта лабораторная работа является частью Rust Book. Вы можете практиковать свои навыки Rust в LabEx.

В этой лабораторной работе нам нужно изменить наш код так, чтобы сообщения об ошибках записывались в стандартный вывод ошибок (stderr), а не в стандартный вывод (stdout).

Skills Graph

Запись сообщений об ошибках в стандартный вывод ошибок вместо стандартного вывода

В настоящее время мы выводим все свои данные в терминал с помощью макроса println!. В большинстве терминалов есть два типа вывода: стандартный вывод (stdout) для общих сведений и стандартный вывод ошибок (stderr) для сообщений об ошибках. Это отличие позволяет пользователям направлять успешный вывод программы в файл, но по-прежнему выводить сообщения об ошибках на экран.

Макрос println! способен только выводить в стандартный вывод, поэтому нам нужно использовать что-то другое для вывода в стандартный вывод ошибок.

Проверка, куда записываются ошибки

Сначала давайте посмотрим, как содержимое, выводимое minigrep, в настоящее время записывается в стандартный вывод, включая любые сообщения об ошибках, которые мы хотели бы записать в стандартный вывод ошибок вместо этого. Мы сделаем это, перенаправляя поток стандартного вывода в файл, в то время как намеренно вызываем ошибку. Мы не будем перенаправлять поток стандартного вывода ошибок, поэтому любое содержимое, отправляемое в стандартный вывод ошибок, будет продолжать отображаться на экране.

Ожидается, что командные строки программы будут отправлять сообщения об ошибках в поток стандартного вывода ошибок, чтобы мы могли по-прежнему видеть сообщения об ошибках на экране, даже если мы перенаправляем поток стандартного вывода в файл. Наша программа в настоящее время не работает правильно: мы вскоре увидим, что она сохраняет вывод сообщения об ошибке в файл вместо этого!

Для демонстрации этого поведения мы запустим программу с > и путём к файлу, output.txt, на который мы хотим перенаправить поток стандартного вывода. Мы не передадим никаких аргументов, что должно вызвать ошибку:

cargo run > output.txt

Синтаксис > сообщает оболочке записать содержимое стандартного вывода в output.txt вместо экрана. Мы не увидели сообщение об ошибке, которое мы ожидали, напечатанное на экране, поэтому это означает, что оно, должно быть, окончалось в файле. Вот что содержит output.txt:

Problem parsing arguments: not enough arguments

Да, наше сообщение об ошибке выводится в стандартный вывод. гораздо более полезно, чтобы сообщения об ошибках такого рода выводились в стандартный вывод ошибок, так что только данные из успешного выполнения окончаются в файле. Мы исправим это.

Вывод ошибок в стандартный вывод ошибок

Мы будем использовать код из Листинга 12-24, чтобы изменить способ вывода сообщений об ошибках. В силу рефакторинга, который мы провели ранее в этом разделе, весь код, который выводит сообщения об ошибках, находится в одной функции main. Стандартная библиотека предоставляет макрос eprintln!, который выводит в поток стандартного вывода ошибок, поэтому давайте изменим два места, где мы вызывали println! для вывода ошибок, чтобы использовать eprintln! вместо этого.

Имя файла: src/main.rs

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!

Это показывает, что мы теперь используем стандартный вывод для успешного вывода и стандартный вывод ошибок для вывода ошибок по-прежнему.

Резюме

Поздравляем! Вы завершили лабораторную работу Запись сообщений об ошибках в стандартный вывод ошибок вместо стандартного вывода. Вы можете практиковать в LabEx более лабораторных работ, чтобы улучшить свои навыки.