Сочетания клавиш

Нажмите ← или → для навигации между главами

Нажмите S или / для поиска по книге

Нажмите ?, чтобы показать эту справку

Нажмите Esc, чтобы скрыть эту справку

Перенаправление ошибок в стандартный поток ошибок

На данный момент мы выводим весь наш вывод в терминал с помощью макроса 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
use std::env;
use std::error::Error;
use std::fs;
use std::process;

use minigrep::{search, search_case_insensitive};

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) = run(config) {
        eprintln!("Application error: {e}");
        process::exit(1);
    }
}

pub struct Config {
    pub query: String,
    pub file_path: String,
    pub ignore_case: bool,
}

impl Config {
    fn build(args: &[String]) -> Result<Config, &'static str> {
        if args.len() < 3 {
            return Err("not enough arguments");
        }

        let query = args[1].clone();
        let file_path = args[2].clone();

        let ignore_case = env::var("IGNORE_CASE").is_ok();

        Ok(Config {
            query,
            file_path,
            ignore_case,
        })
    }
}

fn run(config: Config) -> Result<(), Box<dyn Error>> {
    let contents = fs::read_to_string(config.file_path)?;

    let results = if config.ignore_case {
        search_case_insensitive(&config.query, &contents)
    } else {
        search(&config.query, &contents)
    };

    for line in results {
        println!("{line}");
    }

    Ok(())
}
Листинг 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. Используя аргументы командной строки, файлы, переменные окружения и макрос eprintln! для печати ошибок, вы теперь готовы писать приложения командной строки. В сочетании с концепциями из предыдущих глав ваш код будет хорошо организован, эффективно хранить данные в соответствующих структурах данных, хорошо обрабатывать ошибки и быть хорошо протестированным.

Далее мы рассмотрим некоторые особенности Rust, на которые повлияли функциональные языки: замыкания и итераторы.