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

CKTIS / C++

std::bit_cast — criar um valor a partir de uma representação de bits

std::bit_cast<To>(from) cria um novo objeto a partir dos bits do objeto de origem. Ambos os tipos têm de ter o mesmo tamanho e ser trivialmente copiáveis; não é uma conversão numérica nem um acesso à origem através de um alias.

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

Sintaxe

#include <bit>
template<class To, class From>
constexpr To std::bit_cast(const From& from) noexcept;

std::bit_cast<To>(from)

std::bit_cast, de <bit>, devolve um novo objeto do tipo To. Os bits da sua representação de valor correspondem aos bits da representação do objeto from. Não efetua uma conversão numérica nem cria uma referência à origem. Normalmente, From é deduzido.

A chamada requer sizeof(To) == sizeof(From) e que ambos os tipos sejam trivialmente copiáveis. Estas condições, por si só, não tornam seguros padrões de bits arbitrários: o resultado tem de representar um valor válido do tipo de destino. Os bits de preenchimento do resultado não são especificados; evita dados não inicializados e a transferência de bits de preenchimento para bits de valor.

A função é noexcept. A declaração constexpr não significa que todas as chamadas possam ser avaliadas em tempo de compilação. O exemplo utiliza unsigned char e std::byte para demonstrar esta conversão sem pressupor uma ordem de bytes ou um formato de vírgula flutuante.

Esta entrada tem como âmbito C++23. O documento ligado é um projeto de trabalho em evolução, não uma edição fixa de C++23; as suas regras mais recentes não devem ser aplicadas automaticamente a C++23. Uma opção do compilador num repositório não atesta a compatibilidade do ambiente de execução de produção.

Exemplos

#include <bit>
#include <cstddef>
#include <iostream>

int main() {
    constexpr unsigned char source = 42;
    constexpr auto bits = std::bit_cast<std::byte>(source);
    constexpr auto restored = std::bit_cast<unsigned char>(bits);
    static_assert(restored == source);
    std::cout << static_cast<unsigned int>(restored) << '\n';
}

Resultado

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