Перенаправление ошибок в стандартный поток ошибок
На данный момент мы выводим весь наш вывод в терминал с помощью макроса 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!.
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(())
}
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, на которые повлияли функциональные языки: замыкания и итераторы.