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.