Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::bit_cast — creare un valore da una rappresentazione di bit

std::bit_cast<To>(from) crea un nuovo oggetto a partire dai bit dell’oggetto sorgente. I due tipi devono avere la stessa dimensione ed essere copiabili in modo triviale (trivially copyable); non è né una conversione numerica né un accesso alla sorgente tramite alias.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

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

std::bit_cast<To>(from)

std::bit_cast, definita in <bit>, restituisce un nuovo oggetto di tipo To. I bit della sua rappresentazione del valore corrispondono ai bit della rappresentazione dell’oggetto from. Non esegue conversioni numeriche e non crea riferimenti alla sorgente. From viene normalmente dedotto.

La chiamata richiede sizeof(To) == sizeof(From) e che entrambi i tipi siano copiabili in modo triviale (trivially copyable). Queste condizioni, da sole, non rendono sicuri schemi di bit arbitrari: il risultato deve rappresentare un valore valido del tipo di destinazione. I bit di padding del risultato non sono specificati; evita dati non inizializzati e il trasferimento di padding nei bit del valore.

La funzione è noexcept. La dichiarazione constexpr non significa che ogni chiamata possa essere valutata in fase di compilazione. L’esempio usa unsigned char e std::byte per mostrare questa conversione senza presupporre un ordine dei byte o un formato in virgola mobile.

Questa voce riguarda C++23. Il documento collegato è una bozza di lavoro in evoluzione, non un’edizione definitiva di C++23; le sue regole più recenti non vanno applicate automaticamente a C++23. Un’opzione del compilatore in un repository non attesta la compatibilità dell’ambiente di esecuzione di produzione.

Esempi

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

Risultato

42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti