Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::current_exception — conservar a exceção tratada

std::current_exception, de <exception>, devolve um std::exception_ptr que referencia a exceção atualmente tratada ou uma cópia. Permite conservar uma exceção e lançá-la novamente mais tarde; se não houver nenhuma exceção a ser tratada, devolve um valor nulo.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

std::current_exception() de <exception> captura a exceção atualmente tratada, normalmente dentro de um bloco catch. Devolve um std::exception_ptr que referencia essa exceção ou uma cópia. Se não houver nenhuma exceção a ser tratada, o resultado é nulo: a função não mantém um histórico de erros.

O objeto conservado permanece válido, pelo menos, enquanto existir um std::exception_ptr que o referencie, mesmo depois de o bloco catch terminar. Para lançar novamente a exceção mais tarde, use std::rethrow_exception(saved). Verifique primeiro if (saved): essa função exige um argumento não nulo.

noexcept significa que a própria captura não lança uma exceção para o chamador. No entanto, uma falha de alocação pode conservar std::bad_alloc; uma falha de cópia pode conservar a exceção lançada durante a cópia ou std::bad_exception. Também não presuma que duas chamadas consecutivas referenciam o mesmo objeto.

O exemplo verifica se o resultado é nulo antes de tratar exceções; em seguida, conserva 42 e volta a lançá-la depois de sair do bloco catch. O código destina-se a C++23; as fontes fornecidas são um projeto de trabalho atualizado continuamente, não uma publicação C++23 fixa.

Exemplos

#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";
        }
    }
}

Resultado

true
42

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes