Main function

Ein Programm muss eine globale Namespace-Funktion namens main enthalten, die den festgelegten Startpunkt des Programms in einer gehosteten Umgebung darstellt. Sie muss eine der folgenden Formen haben:

Erklärung

Die main -Funktion wird beim Programmstart nach der Initialisierung der nicht-lokalen Objekte mit statischer Speicherdauer aufgerufen. Sie ist der festgelegte Einsprungspunkt für ein Programm, das in einer gehosteten Umgebung ausgeführt wird (d.h. mit einem Betriebssystem). Die Einsprungspunkte für freistehende Programme (Bootloader, Betriebssystemkerne etc.) sind implementierungsdefiniert.

Die Parameter der zweiparametrigen Form der main -Funktion ermöglichen die Übergabe beliebiger Multibyte-Zeichenketten aus der Ausführungsumgebung (üblicherweise als Kommandozeilenargumente bekannt). Die Zeiger [ argv [ 1 ] , argv [ argc - 1 ] ] zeigen auf die ersten Zeichen jeder dieser Zeichenketten. argv [ 0 ] (falls nicht null) ist der Zeiger auf das Anfangszeichen einer nullterminierten Multibyte-Zeichenkette, die den Namen repräsentiert, mit dem das Programm selbst aufgerufen wurde (oder eine leere Zeichenkette "" , falls dies von der Ausführungsumgebung nicht unterstützt wird). Die Zeichenketten sind modifizierbar, obwohl diese Änderungen nicht an die Ausführungsumgebung zurückgegeben werden: Sie können beispielsweise mit std::strtok verwendet werden. Die Größe des von argv referenzierten Arrays beträgt mindestens argc + 1 , und das letzte Element, argv [ argc ] , ist garantiert ein Nullzeiger.

Die main Funktion besitzt die folgenden besonderen Eigenschaften:

Die main -Funktion unterliegt mehreren Einschränkungen (deren Verletzung das Programm fehlerhaft macht):

Hinweise

Wenn die main -Funktion mit einem Funktions- try -Block definiert wird, werden die Ausnahmen, die von den Destruktoren statischer Objekte ausgelöst werden (die durch den impliziten Aufruf von std::exit zerstört werden), nicht davon abgefangen .

Die Art und Weise, in der die Argumente, die in der OS-Kommandozeile angegeben werden, in die Multibyte-Zeichenarrays konvertiert werden, auf die durch argv verwiesen wird, kann implementierungsdefinierte Verarbeitung beinhalten:

• Parsing von C++ Kommandozeilenargumenten MSDN
• Shell-Einführung POSIX

Eine sehr häufige implementationsdefinierte Form von main ( ) hat ein drittes Argument (zusätzlich zu argc und argv ) vom Typ char ** , das auf ein Array von Zeigern auf die Umgebungsvariablen zeigt.

Beispiel

#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

Referenzen

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch