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

CKTIS / C++

throw — lançar e voltar a lançar exceções

A palavra-chave throw lança uma exceção a partir de uma expressão ou volta a lançar a exceção atualmente tratada. Aprende a diferença entre throw expression; e throw;, como funciona o desenrolamento da pilha e que situações conduzem a std::terminate.

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

Sintaxe

throw expression;
throw;

throw expression; cria um objeto de exceção e inicia a transferência do controlo para um catch correspondente. A própria expressão throw tem o tipo void; o ponto e vírgula termina a instrução. Uma exceção não tem de derivar de uma classe de biblioteca — o exemplo utiliza Error.

throw; volta a lançar a exceção atualmente tratada sem criar um novo objeto. Se não existir uma exceção desse tipo, chama std::terminate. Não o substituas sem cuidado por throw e;: essa forma inicializa um novo objeto a partir da expressão e e pode eliminar a parte derivada quando e se refere a uma classe base.

Os handlers são verificados pela ordem em que aparecem no código-fonte; catch (...) corresponde a qualquer exceção e tem de ser o último. Capturar objetos de classe através de uma referência const, como em const Error&, evita copiar o parâmetro do handler. Durante o desenrolamento da pilha até um handler, os objetos automáticos construídos nos âmbitos abandonados são destruídos pela ordem inversa à da conclusão da sua construção.

A ausência de um handler correspondente, ou a propagação para fora de uma função noexcept, conduz a std::terminate; nesses casos, não pressuponhas que o desenrolamento da pilha é completo. Uma exceção que escape de um destrutor chamado diretamente pelo mecanismo de desenrolamento da pilha também conduz a std::terminate. Um destrutor chamado indiretamente no âmbito da limpeza pode lançar uma exceção sem que esta regra se aplique, se a exceção for capturada antes de escapar do destrutor chamado diretamente. Esta entrada aborda C++23; as fontes fornecidas são um projeto de trabalho em evolução, não uma publicação definitiva de C++23.

Exemplos

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

Resultado

rethrow
caught 7

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