Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

throw — lanciare e rilanciare eccezioni

La parola chiave throw lancia un’eccezione a partire da un’espressione oppure rilancia l’eccezione attualmente gestita. Scopri la differenza tra throw expression; e throw;, come funziona lo stack unwinding e quali situazioni portano a std::terminate.

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

Sintassi

throw expression;
throw;

throw expression; crea un oggetto eccezione e avvia il trasferimento del controllo a un gestore catch corrispondente. L’espressione throw stessa ha tipo void; il punto e virgola termina l’istruzione. Un’eccezione non deve necessariamente derivare da una classe di libreria: nell’esempio si usa Error.

throw; rilancia l’eccezione attualmente gestita senza creare un nuovo oggetto. Se non è presente un’eccezione di questo tipo, chiama std::terminate. Non sostituirlo con leggerezza con throw e;: questa forma inizializza un nuovo oggetto dall’espressione e e può eliminare la parte derivata quando e fa riferimento a una classe base.

I gestori vengono controllati nell’ordine in cui compaiono nel codice sorgente; catch (...) corrisponde a qualsiasi eccezione e deve essere l’ultimo. Catturare oggetti di classe tramite riferimento const, come in const Error&, evita di copiare il parametro del gestore. Durante lo stack unwinding verso un gestore, gli oggetti automatici costruiti negli ambiti abbandonati vengono distrutti nell’ordine inverso a quello di completamento della loro costruzione.

L’assenza di un gestore corrispondente, o la propagazione fuori da una funzione noexcept, porta a std::terminate; in questi casi non dare per scontato che lo stack unwinding sia completo. Anche un’eccezione che si propaga fuori da un distruttore invocato direttamente dal meccanismo di stack unwinding porta a std::terminate. Un distruttore invocato indirettamente durante le operazioni di pulizia può lanciare un’eccezione senza che si applichi questa regola, se l’eccezione viene catturata prima che si propaghi fuori dal distruttore invocato direttamente. Questa voce riguarda C++23; le fonti fornite sono una bozza di lavoro in evoluzione, non una pubblicazione C++23 definitiva.

Esempi

#include <iostream>

struct Error {
    int code;
};

void fail() {
    try {
        throw Error{7};
    } catch (const Error&) {
        std::cout << "rethrow\n";
        throw;
    }
}

int main() {
    try {
        fail();
    } catch (const Error& e) {
        std::cout << "caught " << e.code << '\n';
    }
}

Risultato

rethrow
caught 7

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