Main function
A program shall contain a global namespace function named main, which is the designated start of the program in hosted environment. It shall have one of the following forms:
int main() { body }
|
(1) | ||||||||
int main(int argc, char* argv[]) { body }
|
(2) | ||||||||
int main(/* implementation-defined */) { body }
|
(3) | ||||||||
main function running independently of environment-provided arguments.main function accepting environment-provided arguments.main function of implement-defined type, returning int.main functions to place the extra (optional) parameters after argv.| argc | - | Non-negative value representing the number of arguments passed to the program from the environment in which the program is run. |
| argv | - | Pointer to the first element of an array of argc + 1 pointers, of which the last one is null and the previous ones, if any, point to null-terminated multibyte strings that represent the arguments passed to the program from the execution environment. If argv[0] is not a null pointer (or, equivalently, if argc > 0), it points to a string that represents the name used to invoke the program, or to an empty string. |
| body | - | The body of the main function.
|
Contents |
[edit] Explanation
The main function is called at program startup after initialization of the non-local objects with static storage duration. It is the designated entry point to a program that is executed in hosted environment (that is, with an operating system). The entry points to freestanding programs (boot loaders, OS kernels, etc) are implementation-defined.
The parameters of the two-parameter form of the main function allow arbitrary multibyte character strings to be passed from the execution environment (these are typically known as command line arguments), the pointers [argv[1], argv[argc - 1]] point at the first characters in each of these strings. argv[0] (if non-null) is the pointer to the initial character of a null-terminated multibyte string that represents the name used to invoke the program itself (or an empty string "" if this is not supported by the execution environment). The strings are modifiable, although these modifications do not propagate back to the execution environment: they can be used, for example, with std::strtok. The size of the array pointed to by argv is at least argc + 1, and the last element, argv[argc], is guaranteed to be a null pointer.
The main function has the following several special properties:
main function does not need to contain the return statement: if control reaches the end of main without encountering a return statement, the effect is that of executing return 0;.main) is equivalent to first leaving the function normally (which destroys the objects with automatic storage duration and evaluates any postcondition assertions of main(since C++26)) and then calling std::exit with the same argument as the argument of the return (std::exit then destroys static objects and terminates the program).The main function has several restrictions (violation of which renders the program ill-formed):
main in the global namespace is reserved for functions (although it can be used to name classes, namespaces, enumerations, and any entity in a non-global namespace, except that an entity named main cannot be declared with C language linkage in any namespace).constexpr(since C++11), consteval(since C++20), inline, or static.|
4) The return type of the main function cannot be deduced (auto main() {...} is not allowed).
|
(since C++14) |
|
6) The main function cannot attach to a named |