Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::current_exception — conservare l’eccezione gestita

std::current_exception, dichiarata in <exception>, restituisce uno std::exception_ptr che fa riferimento all’eccezione attualmente gestita o a una sua copia. Permette di conservare un’eccezione e rilanciarla in seguito; se non è gestita alcuna eccezione, restituisce un valore nullo.

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

Sintassi

#include <exception>
std::exception_ptr std::current_exception() noexcept;

std::current_exception() di <exception> cattura l’eccezione attualmente gestita, di solito all’interno di un blocco catch. Restituisce uno std::exception_ptr che fa riferimento a quell’eccezione o a una sua copia. Se non è gestita alcuna eccezione, il risultato è nullo: la funzione non conserva la cronologia degli errori.

L’oggetto conservato rimane valido almeno finché esiste uno std::exception_ptr che vi fa riferimento, anche dopo la fine del blocco catch. Per rilanciare l’eccezione in seguito, usa std::rethrow_exception(saved). Controlla prima if (saved): la funzione richiede un argomento non nullo.

noexcept significa che la cattura in sé non lancia un’eccezione al chiamante. Tuttavia, un errore di allocazione può conservare std::bad_alloc; un errore di copia può conservare l’eccezione lanciata durante la copia oppure std::bad_exception. Inoltre, non presumere che due chiamate consecutive facciano riferimento allo stesso oggetto.

L’esempio controlla che il risultato sia nullo prima di gestire eccezioni, quindi conserva 42 e la rilancia dopo essere uscito dal blocco catch. Il codice è destinato a C++23; le fonti fornite sono una bozza di lavoro in continuo aggiornamento, non una pubblicazione C++23 definitiva.

Esempi

#include <exception>
#include <iostream>

int main() {
    std::cout << std::boolalpha << !std::current_exception() << '\n';

    std::exception_ptr saved;
    try {
        throw 42;
    } catch (...) {
        saved = std::current_exception();
    }

    if (saved) {
        try {
            std::rethrow_exception(saved);
        } catch (int value) {
            std::cout << value << '\n';
        } catch (...) {
            std::cout << "capture or rethrow failed\n";
        }
    }
}

Risultato

true
42

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