Основная функция

Программа должна содержать глобальную функцию, именуемую main, которая является назначенной точкой входа программы в среде выполнения. Она должна иметь один из следующих видов:

Имена argc и argv произвольные, а также представление типов параметров: int main(int ac, char** av) также допустимо.

Очень распространённый реализационный вид main() имеет третий аргумент (в дополнение к argc и argv), типа char**, указывающий на массив указателей на переменные среды выполнения.

Объяснение

Функция main вызывается при запуске программы после инициализации нелокальных объектов со статическим временем жизни. Она является назначенной точкой входа в программу, которая выполняется в среде выполнения (то есть, с операционной системой). Точки входа в самостоятельные программы (загрузчики, ядра ОС и т. д.) определяются реализацией.

Параметры двухпараметрического вида функции main позволяют передавать произвольные многобайтовые строки из среды выполнения (обычно их называют аргументами командной строки), указатели argv[1] .. argv[argc - 1] указывают на первые символы в каждой из этих строк. argv[0] (если не равен null) — указатель на начальный символ строки с нулевым завершением многобайтовых символов, представляющей имя, используемое для вызова самой программы (или пустая строка "" если это не поддерживается средой выполнения). Строки изменяемы, хотя эти изменения не распространяются обратно в среду выполнения: их можно использовать, например, с std::strtok. Размер массива, на который указывает argv, по меньшей мере, argc + 1, и последний элемент, argv[argc], гарантированно является нулевым указателем.

Функция main обладает несколькими особыми свойствами:

Примечания

Если функция main определена с блоком try-catch, исключения, сгенерированные деструкторами статических объектов (которые уничтожаются неявным std::exit), не перехватываются им.

Способ, которым аргументы, предоставленные в командной строке ОС, преобразуются в многобайтовые массивы символов, на которые ссылаются argv, может включать реализационно-зависимую обработку:

• Разбор аргументов командной строки C++ MSDN
• Введение в оболочку POSIX

Пример

#include <cstdlib>
#include <iomanip>
#include <iostream>
 
int main(int argc, char *argv[])
{
    std::cout << "argc == " << argc << '\n';
 
    for (int ndx{}; ndx != argc; ++ndx)
        std::cout << "argv[" << ndx << "] == " << std::quoted(argv[ndx]) << '\n';
    std::cout << "argv[" << argc << "] == "
              << static_cast<void*>(argv[argc]) << '\n';
 
    /*...*/
 
    return argc == 3 ? EXIT_SUCCESS : EXIT_FAILURE; // optional return value
}

argc == 3
argv[0] == "./convert"
argv[1] == "table_in.dat"
argv[2] == "table_out.dat"
argv[3] == 0

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также