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

CKTIS / C++

dynamic_cast — conversão verificada em hierarquias de classes

dynamic_cast converte apontadores e referências em hierarquias de classes, verificando em tempo de execução as conversões que o exigem. Uma conversão de apontador que falhe devolve nullptr, enquanto uma conversão de referência que falhe lança std::bad_cast.

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

Sintaxe

dynamic_cast<T>(expression)

dynamic_cast<T>(expression) converte apontadores ou referências em hierarquias de classes. T tem de ser um apontador ou uma referência para um tipo de classe completo, ou um apontador para void, com qualificadores cv opcionais. O operador não pode remover os qualificadores const nem volatile.

As conversões descendentes para classes derivadas e as conversões cruzadas entre ramos de herança exigem um tipo de origem polimórfico: uma classe com, pelo menos, uma função virtual. O êxito depende do objeto real e das regras de herança pública e não ambígua. Uma conversão ascendente para uma classe base acessível e não ambígua não exige polimorfismo; normalmente, basta uma conversão implícita.

Se a verificação de um apontador falhar, o resultado é nullptr; se falhar a verificação de uma referência, é lançado std::bad_cast, declarado em <typeinfo>. Um apontador de entrada nulo produz um apontador de resultado nulo. A conversão para um apontador para void exige que o tipo estático para o qual p aponta seja polimórfico. Se p não for nulo, o resultado aponta para o objeto mais derivado. O tipo para o qual aponta o resultado tem de conservar os qualificadores const e volatile presentes no tipo para o qual p aponta. Por exemplo, se p apontar para um tipo polimórfico qualificado com const, mas não com volatile, usa-se dynamic_cast<const void*>(p) em vez de dynamic_cast<void*>(p). O operador não valida apontadores pendentes: a violação dos requisitos relativos ao tempo de vida do objeto pode causar comportamento indefinido.

O exemplo demonstra um caso de sucesso e as duas formas de falha. Destina-se a C++23; o URL do padrão fornecido remete para um rascunho em evolução, não para uma publicação definitiva de C++23. O exemplo foi executado num ambiente isolado; a execução em ambiente de produção não está confirmada.

Exemplos

#include <iostream>
#include <typeinfo>

struct Base {
    virtual ~Base() = default;
};

struct Derived : Base {
    int value = 42;
};

int main() {
    Derived derived;
    Base base;
    Base* good = &derived;
    Base* other = &base;

    if (auto* p = dynamic_cast<Derived*>(good)) {
        std::cout << p->value << '\n';
    }
    std::cout << std::boolalpha
              << (dynamic_cast<Derived*>(other) == nullptr) << '\n';

    try {
        (void)dynamic_cast<Derived&>(*other);
    } catch (const std::bad_cast&) {
        std::cout << "bad_cast\n";
    }
}

Resultado

42
true
bad_cast

O código apresentado foi executado sem alterações num ambiente isolado. A saída padrão (`stdout`) correspondeu exatamente à saída indicada.

Fontes