Аргументы командной строки в C++: argc и argv простыми словами
Поисковый запрос argc argv C++ часто появляется у новичков, когда нужно сделать программу не просто учебной, а удобной для запуска из терминала. Аргументы командной строки позволяют передавать данные в программу прямо при старте: путь к файлу, число повторов, режим работы, флаги вроде --verbose или --help.
Что такое argc и argv в C++
Обычно функцию main пишут так:
int main() {
return 0;
}
Но у неё есть и другая распространённая форма:
int main(int argc, char* argv[]) {
return 0;
}
- argc — количество аргументов командной строки;
- argv — массив C-строк с самими аргументами;
- argv[0] обычно содержит имя программы или путь к исполняемому файлу;
- argv[1], argv[2] и далее — параметры, которые передал пользователь.
Первый пример: вывести все аргументы
Начнём с программы, которая просто показывает, что именно пришло в argv.
#include <iostream>
int main(int argc, char* argv[]) {
std::cout << "Количество аргументов: " << argc << '\n';
for (int i = 0; i < argc; ++i) {
std::cout << "argv[" << i << "] = " << argv[i] << '\n';
}
return 0;
}
Если скомпилировать и запустить программу так:
g++ main.cpp -o app
./app input.txt --verbose 10
Вы получите примерно такой вывод:
Количество аргументов: 4
argv[0] = ./app
argv[1] = input.txt
argv[2] = --verbose
argv[3] = 10
Важно: пользовательских аргументов здесь три, но argc равен четырём, потому что argv[0] тоже учитывается.
Как проверить, что аргумент передан
Частая ошибка новичков — сразу обращаться к argv[1], не проверяя argc. Если аргумент не передан, программа может работать некорректно.
#include <iostream>
int main(int argc, char* argv[]) {
if (argc < 2) {
std::cerr << "Ошибка: укажите имя файла\n";
std::cerr << "Пример: ./app data.txt\n";
return 1;
}
std::cout << "Файл для обработки: " << argv[1] << '\n';
return 0;
}
Код возврата 0 обычно означает успешное завершение, а ненулевой код — ошибку. Это полезно при запуске программ из скриптов и систем автоматизации.
Преобразование аргумента в число
Все значения в argv приходят как строки. Если пользователь передал число, его нужно преобразовать. В современном C++ удобно использовать std::stoi.
#include <iostream>
#include <string>
int main(int argc, char* argv[]) {
if (argc < 2) {
std::cerr << "Укажите количество повторов\n";
return 1;
}
try {
int count = std::stoi(argv[1]);
if (count <= 0) {
std::cerr << "Число должно быть положительным\n";
return 1;
}
for (int i = 0; i < count; ++i) {
std::cout << "Привет!\n";
}
} catch (const std::exception&) {
std::cerr << "Аргумент должен быть числом\n";
return 1;
}
return 0;
}
Запуск:
./app 3
Результат:
Привет!
Привет!
Привет!
Практический пример: простой парсер флагов
Допустим, мы хотим поддержать такие параметры:
- --help — показать справку;
- --verbose — включить подробный режим;
- --file имя — указать файл.
#include <iiostream>
#include <string>
void printHelp() {
std::cout << "Использование:\n";
std::cout << " ./app --file data.txt [--verbose]\n";
std::cout << " ./app --help\n";
}
int main(int argc, char* argv[]) {
bool verbose = false;
std::string fileName;
for (int i = 1; i < argc; ++i) {
std::string arg = argv[i];
if (arg == "--help") {
printHelp();
return 0;
} else if (arg == "--verbose") {
verbose = true;
} else if (arg == "--file") {
if (i + 1 >= argc) {
std::cerr << "Ошибка: после --file нужно указать имя файла\n";
return 1;
}
fileName = argv[++i];
} else {
std::cerr << "Неизвестный аргумент: " << arg << '\n';
return 1;
}
}
if (fileName.empty()) {
std::cerr << "Ошибка: файл не указан\n";
return 1;
}
if (verbose) {
std::cout << "Подробный режим включён\n";
}
std::cout << "Обрабатываем файл: " << fileName << '\n';
return 0;
}
В примере выше есть маленькая, но важная идея: когда встречается --file, мы берём следующий аргумент как значение и увеличиваем индекс через ++i, чтобы не обрабатывать имя файла повторно.
Обратите внимание: в коде должна быть строка #include <iostream>. Если случайно написать iiostream, компилятор сообщит, что такого заголовочного файла нет. Это типичная опечатка, которую легко пропустить.
Аргументы с пробелами
Если аргумент содержит пробелы, его нужно заключать в кавычки:
./app --file "my documents/data.txt"
Тогда путь попадёт в программу как один аргумент, а не как две отдельные строки.
Частые ошибки при работе с argv
- Забывать про argv[0]. Первый пользовательский аргумент — это argv[1], а не argv[0].
- Не проверять argc. Перед обращением к argv[1] убедитесь, что argc >= 2.
- Считать argv обычными string. Это C-строки; при необходимости преобразуйте их в std::string.
- Не обрабатывать ошибки преобразования. Пользователь может передать abc вместо числа.
- Делать слишком сложный парсер вручную. Для больших проектов лучше взять готовую библиотеку, например CLI11, cxxopts или Boost.Program_options.
Рекомендации
Для небольших учебных и консольных программ ручного разбора argc и argv достаточно. Делайте справку через --help, возвращайте понятные коды ошибок, проверяйте наличие значений после флагов и не доверяйте пользовательскому вводу.
Если вы хотите не просто выучить отдельные конструкции, а собрать целостную базу языка, посмотрите курс «C++ с нуля до уверенной практики: пройти путь от первых программ до серьёзных проектов». Аргументы командной строки — как раз одна из тех тем, где теория быстро превращается в полезные реальные инструменты.
Итог
argc и argv в C++ — это стандартный способ получить параметры запуска программы. Запомните главное: argc хранит количество аргументов, argv хранит строки, argv[0] обычно является именем программы, а все пользовательские значения нужно проверять и при необходимости преобразовывать к нужному типу.
-
Создано 20.11.2026 17:00:40
-
Михаил Русаков

Комментарии (0):
Для добавления комментариев надо войти в систему.
Если Вы ещё не зарегистрированы на сайте, то сначала зарегистрируйтесь.