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

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

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

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

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

Приём аргументов командной строки

Давайте создадим новый проект, как всегда, с помощью cargo new. Мы назовём наш проект minigrep, чтобы отличать его от инструмента grep, который, возможно, уже есть в вашей системе:

$ cargo new minigrep
     Created binary (application) `minigrep` project
$ cd minigrep

Первая задача — заставить minigrep принимать два аргумента командной строки: путь к файлу и строку для поиска. То есть мы хотим иметь возможность запускать нашу программу с помощью cargo run, двух дефисов, чтобы указать, что следующие аргументы предназначены для нашей программы, а не для cargo, строки для поиска и пути к файлу для поиска, вот так:

$ cargo run -- searchstring example-filename.txt

Прямо сейчас программа, сгенерированная cargo new, не может обрабатывать аргументы, которые мы ей передаём. Некоторые существующие библиотеки на crates.io могут помочь с написанием программы, принимающей аргументы командной строки, но поскольку вы только изучаете эту концепцию, давайте реализуем эту возможность сами.

Чтение значений аргументов

Чтобы minigrep мог читать значения аргументов командной строки, которые мы ему передаём, нам понадобится функция std::env::args, предоставляемая стандартной библиотекой Rust. Эта функция возвращает итератор по аргументам командной строки, переданным в minigrep. Мы полностью рассмотрим итераторы в главе 13. Пока вам нужно знать только две детали об итераторах: итераторы производят серию значений, и мы можем вызвать метод collect для итератора, чтобы превратить его в коллекцию, такую как вектор, которая содержит все элементы, производимые итератором.

Код в листинге 12-1 позволяет вашей программе minigrep читать любые аргументы командной строки, переданные ей, а затем собирать значения в вектор.

Имя файла: src/main.rs
use std::env;

fn main() {
    let args: Vec<String> = env::args().collect();
    dbg!(args);
}
Листинг 12-1: Сбор аргументов командной строки в вектор и их печать

Сначала мы вводим модуль std::env в область видимости с помощью инструкции use, чтобы мы могли использовать его функцию args. Обратите внимание, что функция std::env::args вложена на два уровня модулей. Как мы обсуждали в главе 7, в случаях, когда нужная функция вложена более чем в один модуль, мы решили ввести в область видимости родительский модуль, а не саму функцию. Поступая так, мы можем легко использовать другие функции из std::env. Это также менее двусмысленно, чем добавление use std::env::args и последующий вызов функции просто как args, потому что args легко можно принять за функцию, определённую в текущем модуле.

Функция args и недопустимый Unicode

Обратите внимание, что std::env::args вызовет панику, если какой-либо аргумент содержит недопустимый Unicode. Если вашей программе нужно принимать аргументы, содержащие недопустимый Unicode, используйте вместо этого std::env::args_os. Эта функция возвращает итератор, который производит значения OsString вместо значений String. Мы выбрали std::env::args здесь для простоты, потому что значения OsString различаются на разных платформах и сложнее в работе, чем значения String.

В первой строке main мы вызываем env::args и сразу используем collect, чтобы превратить итератор в вектор, содержащий все значения, произведённые итератором. Мы можем использовать функцию collect для создания многих видов коллекций, поэтому мы явно аннотируем тип args, чтобы указать, что нам нужен вектор строк. Хотя вам очень редко нужно аннотировать типы в Rust, collect — это одна из функций, для которых вам часто нужно это делать, потому что Rust не может вывести, какой вид коллекции вы хотите.

Наконец, мы печатаем вектор с помощью макроса отладки. Давайте попробуем запустить код сначала без аргументов, а затем с двумя аргументами:

$ cargo run
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.61s
     Running `target/debug/minigrep`
[src/main.rs:5:5] args = [
    "target/debug/minigrep",
]
$ cargo run -- needle haystack
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 1.57s
     Running `target/debug/minigrep needle haystack`
[src/main.rs:5:5] args = [
    "target/debug/minigrep",
    "needle",
    "haystack",
]

Обратите внимание, что первое значение в векторе — "target/debug/minigrep", это имя нашего бинарного файла. Это соответствует поведению списка аргументов в C, позволяя программам использовать имя, под которым они были вызваны при выполнении. Часто удобно иметь доступ к имени программы, если вы хотите напечатать его в сообщениях или изменить поведение программы в зависимости от того, какой псевдоним командной строки был использован для вызова программы. Но для целей этой главы мы проигнорируем его и сохраним только два аргумента, которые нам нужны.

Сохранение значений аргументов в переменных

Программа в настоящее время может получать доступ к значениям, указанным в качестве аргументов командной строки. Теперь нам нужно сохранить значения двух аргументов в переменных, чтобы мы могли использовать эти значения на протяжении всей остальной части программы. Мы делаем это в листинге 12-2.

Имя файла: src/main.rs
use std::env;

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

    let query = &args[1];
    let file_path = &args[2];

    println!("Searching for {query}");
    println!("In file {file_path}");
}
Листинг 12-2: Создание переменных для хранения аргумента запроса и аргумента пути к файлу

Как мы видели при печати вектора, имя программы занимает первое значение в векторе по индексу args[0], поэтому мы начинаем аргументы с индекса 1. Первый аргумент, который принимает minigrep, — это строка, которую мы ищем, поэтому мы помещаем ссылку на первый аргумент в переменную query. Второй аргумент будет путём к файлу, поэтому мы помещаем ссылку на второй аргумент в переменную file_path.

Мы временно печатаем значения этих переменных, чтобы доказать, что код работает так, как мы задумали. Давайте снова запустим эту программу с аргументами test и sample.txt:

$ cargo run -- test sample.txt
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.0s
     Running `target/debug/minigrep test sample.txt`
Searching for test
In file sample.txt

Отлично, программа работает! Значения нужных нам аргументов сохраняются в правильные переменные. Позже мы добавим некоторую обработку ошибок для работы с некоторыми возможными ошибочными ситуациями, например, когда пользователь не предоставляет аргументы; пока мы проигнорируем эту ситуацию и вместо этого займёмся добавлением возможностей чтения файлов.