CKTIS / C++
std::terminate — beëindigen zonder terug te keren
std::terminate, gedeclareerd in <exception>, roept een programma-beëindigingshandler aan en keert nooit terug. De functie wordt onder meer geactiveerd door een niet-afgevangen uitzondering of een uitzondering die uit een noexcept-functie ontsnapt; expliciet aanroepen kan ook. Opruimen van resources via destructors is niet gegarandeerd.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <exception>
[[noreturn]] void std::terminate() noexcept;std::terminate() uit <exception> neemt geen argumenten aan en keert nooit terug. De functie roept een handler van het type std::terminate_handler aan; de standaardhandler roept std::abort() aan. Dit is geen uitzondering gooien en ook geen herstelmechanisme dat catch kan afvangen.
Veelvoorkomende oorzaken zijn dat er geen passende catch is, dat een uitzondering uit een noexcept-functie ontsnapt, dat een destructor tijdens het afwikkelen van de stack eindigt met het gooien van een uitzondering, en dat een std::thread-object wordt vernietigd terwijl het nog joinable() is. Een programma kan std::terminate() ook expliciet aanroepen.
Ga niet uit van volledige RAII-opruiming. Als er geen passende exception handler is, is het afwikkelen van de stack implementatieafhankelijk; wanneer een uitzondering uit een noexcept-functie ontsnapt, kan het afwikkelen volledig, gedeeltelijk of afwezig zijn. Een expliciete aanroep van std::terminate() wikkelt de stack zelf niet af.
Met std::set_terminate installeer je een aangepaste handler. Die handler moet het programma beëindigen zonder naar de aanroeper terug te keren. Het voorbeeld installeert stop, dat std::_Exit(EXIT_FAILURE) aanroept: geen tekstuitvoer, een beëindigingsstatus die een fout aangeeft, en geen uitvoering van destructors of functies die met std::atexit zijn geregistreerd. Voer het uit als een afzonderlijk proces.
Dit artikel behandelt C++23. De opgegeven pagina’s zijn een evoluerend concept van de standaard en bevatten ook latere toevoegingen; dit artikel schrijft die toevoegingen niet toe aan C++23. Een compileroptie in de repository bevestigt niet de productie-runtime.
Voorbeelden
#include <cstdlib>
#include <exception>
[[noreturn]] void stop() noexcept {
std::_Exit(EXIT_FAILURE);
}
int main() {
std::set_terminate(stop);
std::terminate();
}
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.