Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::terminate — terminare senza ritornare

std::terminate, dichiarata in <exception>, invoca un gestore di terminazione del programma e non ritorna mai. Viene attivata, tra gli altri casi, da un’eccezione non gestita o da un’eccezione che esce da una funzione noexcept; può anche essere chiamata esplicitamente. Non garantisce la pulizia delle risorse tramite i distruttori.

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

Sintassi

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

std::terminate() di <exception> non accetta argomenti e non ritorna mai. Invoca un gestore di tipo std::terminate_handler; il gestore predefinito chiama std::abort(). Non si tratta di lanciare un’eccezione né di un meccanismo di recupero che catch possa intercettare.

Tra le cause tipiche ci sono l’assenza di un catch corrispondente, un’eccezione che esce da una funzione noexcept, un distruttore che termina lanciando un’eccezione durante lo svolgimento dello stack e la distruzione di un oggetto std::thread ancora joinable(). Un programma può anche chiamare esplicitamente std::terminate().

Non dare per scontata una pulizia RAII completa. Se non esiste un gestore di eccezioni corrispondente, lo svolgimento dello stack dipende dall’implementazione; quando un’eccezione esce da una funzione noexcept, lo svolgimento può essere completo, parziale o assente. Una chiamata esplicita a std::terminate() non svolge lo stack.

std::set_terminate consente di installare un gestore personalizzato. Il gestore deve terminare il programma senza ritornare al chiamante. L’esempio installa stop, che chiama std::_Exit(EXIT_FAILURE): nessun output testuale, uno stato di terminazione che indica un fallimento e nessuna esecuzione dei distruttori o delle funzioni registrate con std::atexit. Esegui l’esempio come processo separato.

Questa voce riguarda C++23. Le pagine fornite sono una bozza dello standard in evoluzione e contengono anche aggiunte successive; questa voce non attribuisce tali aggiunte a C++23. Un’opzione del compilatore nel repository non certifica l’ambiente di esecuzione di produzione.

Esempi

#include <cstdlib>
#include <exception>

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

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti