WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::terminate — Beenden ohne Rückkehr

std::terminate aus <exception> ruft eine Programmbeendigungsroutine auf und kehrt nie zurück. Ausgelöst wird sie unter anderem durch eine nicht behandelte Ausnahme oder eine Ausnahme, die aus einer noexcept-Funktion entkommt; sie kann auch ausdrücklich aufgerufen werden. Eine Bereinigung von Ressourcen durch Destruktoren ist nicht garantiert.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <exception>
[[noreturn]] void std::terminate() noexcept;

std::terminate() aus <exception> nimmt keine Argumente an und kehrt nie zurück. Die Funktion ruft einen Handler vom Typ std::terminate_handler auf; der Standard-Handler ruft std::abort() auf. Dabei wird keine Ausnahme ausgelöst, und es handelt sich nicht um einen Wiederherstellungsmechanismus, den catch abfangen kann.

Typische Auslöser sind ein fehlender passender catch-Block, eine Ausnahme, die aus einer noexcept-Funktion entkommt, ein Destruktor, der während des Stack-Unwinding eine Ausnahme auslöst, sowie das Zerstören eines std::thread-Objekts, das noch joinable() ist. Ein Programm kann std::terminate() auch ausdrücklich aufrufen.

Gehe nicht von einer vollständigen RAII-Bereinigung aus. Gibt es keinen passenden Ausnahme-Handler, ist das Stack-Unwinding implementierungsabhängig; entkommt eine Ausnahme einer noexcept-Funktion, kann das Unwinding vollständig, teilweise oder gar nicht stattfinden. Ein ausdrücklicher Aufruf von std::terminate() selbst führt zu keinem Stack-Unwinding.

Mit std::set_terminate lässt sich ein eigener Handler installieren. Dieser muss das Programm beenden, ohne zum Aufrufer zurückzukehren. Das Beispiel installiert stop, das std::_Exit(EXIT_FAILURE) aufruft: Es gibt keine Textausgabe, der Beendigungsstatus signalisiert einen Fehler, und weder Destruktoren noch mit std::atexit registrierte Funktionen werden ausgeführt. Führe das Beispiel als separaten Prozess aus.

Dieser Eintrag bezieht sich auf C++23. Die angegebenen Seiten sind ein fortlaufend weiterentwickelter Standardentwurf und enthalten auch spätere Ergänzungen; dieser Eintrag ordnet diese Ergänzungen nicht C++23 zu. Ein Compiler-Flag im Repository bestätigt nicht die Produktionslaufzeit.

Beispiele

#include <cstdlib>
#include <exception>

[[noreturn]] void stop() noexcept {
    std::_Exit(EXIT_FAILURE);
}

int main() {
    std::set_terminate(stop);
    std::terminate();
}

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen