Main function

Un programme doit contenir une fonction de l'espace de noms global nommée main , qui est le point de départ désigné du programme dans un environnement hébergé. Elle doit avoir l'une des formes suivantes :

Explication

La fonction main est appelée au démarrage du programme après l'initialisation des objets non locaux ayant une durée de stockage statique. C'est le point d'entrée désigné d'un programme exécuté dans un environnement hébergé (c'est-à-dire avec un système d'exploitation). Les points d'entrée des programmes autonomes (chargeurs d'amorçage, noyaux de système d'exploitation, etc.) sont définis par l'implémentation.

Les paramètres de la forme à deux paramètres de la fonction main permettent de transmettre des chaînes de caractères multioctets arbitraires depuis l'environnement d'exécution (généralement appelées arguments de ligne de commande ), les pointeurs [ argv [ 1 ] , argv [ argc - 1 ] ] pointent vers les premiers caractères de chacune de ces chaînes. argv [ 0 ] (s'il n'est pas nul) est le pointeur vers le caractère initial d'une chaîne multioctets terminée par un caractère nul qui représente le nom utilisé pour invoquer le programme lui-même (ou une chaîne vide "" si cela n'est pas pris en charge par l'environnement d'exécution). Les chaînes sont modifiables, bien que ces modifications ne se propagent pas en retour vers l'environnement d'exécution : elles peuvent être utilisées, par exemple, avec std::strtok . La taille du tableau pointé par argv est au moins argc + 1 , et le dernier élément, argv [ argc ] , est garanti être un pointeur nul.

La fonction main possède les propriétés spéciales suivantes :

La fonction main possède plusieurs restrictions (dont la violation rend le programme mal formé) :

Notes

Si la fonction main est définie avec un bloc try de fonction , les exceptions levées par les destructeurs des objets statiques (qui sont détruits par l'appel implicite à std::exit ) ne sont pas interceptées par celui-ci.

La manière dont les arguments fournis sur la ligne de commande du système d'exploitation sont convertis en tableaux de caractères multioctets référencés par argv peut impliquer un traitement défini par l'implémentation :

• Analyse des Arguments de Ligne de Commande en C++ MSDN
• Introduction au Shell POSIX

Une implémentation très courante définie par l'implémentation de main ( ) possède un troisième argument (en plus de argc et argv ), de type char ** , pointant vers un tableau de pointeurs vers les variables d'environnement d'exécution .

Exemple

#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

Références

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi