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

CKTIS / C++

static_cast — conversão explícita de tipo

static_cast<T>(expression) converte explicitamente uma expressão para T de acordo com as regras de conversão da linguagem. O compilador verifica se a conversão é permitida, mas não garante a preservação do valor nem a validade de uma conversão descendente numa hierarquia de classes.

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

Sintaxe

static_cast<T>(expression)

static_cast<T>(expression) pede uma conversão explícita para T. Suporta, entre outros casos, conversões numéricas e de enumerações, bem como inicializações que utilizem construtores ou funções de conversão explicit adequados. static_cast não pode remover const ou volatile do tipo para o qual um ponteiro aponta ou ao qual uma referência se refere. No entanto, uma conversão que produz um valor pode omitir os qualificadores de nível superior. Por exemplo, static_cast<int*>(p) é válido quando p é do tipo int* const: o valor de ponteiro resultante não tem const de nível superior e o tipo apontado permanece inalterado.

Uma conversão para uma referência lvalue produz um lvalue; para uma referência rvalue a um objeto, produz um xvalue. Nos restantes casos, produz um prvalue, exceto quando uma referência rvalue a uma função produz um lvalue. Converter para void descarta o valor da expressão, mas não a sua execução.

Uma conversão permitida de uma classe base para uma derivada não verifica em tempo de execução o tipo real do objeto. Um objeto incorreto provoca comportamento indefinido; converter um ponteiro nulo produz um ponteiro nulo. É proibida uma conversão descendente através de uma classe base virtual.

A conversão de um número de vírgula flutuante para int descarta a parte fracionária na direção de zero. Se o valor truncado não couber em int, o comportamento é indefinido. No exemplo, converter total antes da divisão evita a divisão inteira. Converter depois o resultado de total / count não recupera a parte fracionária perdida.

Exemplos

#include <iostream>

int main() {
    const int total = 7;
    const int count = 2;
    const double ratio = static_cast<double>(total) / count;
    const int truncated = static_cast<int>(-3.75);

    std::cout << ratio << '\n' << truncated << '\n';
}

Resultado

3.5
-3

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