Namensräume
Varianten
Aktionen

std::_Exit

Von cppreference.com
< cpp‎ | utility‎ | program
 
 
Dienstprogramm-Bibliotheken
Sprachunterstützung
Typunterstützung (Basistypen, RTTI)
Bibliotheks-Feature-Test-Makros (C++20)
Programm-Dienstprogramme
Variadische Funktionen
Coroutine-Unterstützung (C++20)
Vertragsunterstützung (C++26)
Drei-Wege-Vergleich
(C++20)
(C++20)(C++20)(C++20)  
(C++20)(C++20)(C++20)

Allgemeine Hilfsmittel
Relationale Operatoren (in C++20 veraltet)
 
 
Definiert in Header <cstdlib>
[[noreturn]] void _Exit( int exit_code ) noexcept;
(seit C++11)

Verursacht die normale Programmbeendigung, ohne die Ressourcen vollständig zu bereinigen.

Destruktoren von Variablen mit automatischen, Thread-lokalen und statischen Speicherklassen sind nicht betroffen. Funktionen, die an std::at_quick_exit() oder std::atexit() übergeben wurden, werden nicht aufgerufen. Ob offene Ressourcen wie Dateien geschlossen werden, ist implementierungsabhängig.

Wenn exit_code 0 oder EXIT_SUCCESS ist, wird ein implementierungsdefinierter Status, der eine erfolgreiche Beendigung anzeigt, an die Host-Umgebung zurückgegeben. Wenn exit_code EXIT_FAILURE ist, wird ein implementierungsdefinierter Status, der eine *nicht erfolgreiche* Beendigung anzeigt, zurückgegeben. In anderen Fällen wird ein implementierungsdefinierter Statuswert zurückgegeben.

Eine freistehende Implementierung muss std::_Exit bereitstellen.

(seit C++23)

Inhalt

[bearbeiten] Parameter

exit_code - Beendigungsstatus des Programms

[bearbeiten] Rückgabewert

(keine)

[bearbeiten] Hinweise

Obwohl _Exit seit C++23 freistehend sein muss, ist es in einer freistehenden C-Implementierung nicht zwingend erforderlich, dass es verfügbar ist.

[bearbeiten] Beispiel

#include <iostream>
 
class Static
{
public:
    ~Static() 
    {
        std::cout << "Static dtor\n";
    }
};
 
class Local
{
public:
    ~Local() 
    {
        std::cout << "Local dtor\n";
    }
};
 
Static static_variable; // dtor of this object will *not* be called
 
void atexit_handler()
{
    std::cout << "atexit handler\n";
}
 
int main()
{
    Local local_variable; // dtor of this object will *not* be called
 
    // handler will *not* be called
    const int result = std::atexit(atexit_handler);
 
    if (result != 0)
    {
        std::cerr << "atexit registration failed\n";
        return EXIT_FAILURE;
    }
 
    std::cout << "test" << std::endl; // flush from std::endl
        // needs to be here, otherwise nothing will be printed
    std::_Exit(EXIT_FAILURE);
}

Ausgabe

test

[bearbeiten] Siehe auch

verursacht abnormalen Programmabbruch (ohne Bereinigung)
(funktion) [bearbeiten]
verursacht normalen Programmabbruch mit Bereinigung
(funktion) [bearbeiten]
C-Dokumentation für _Exit