CKTIS / C++
std::bit_cast — stvaranje vrijednosti iz bitnog prikaza
std::bit_cast<To>(from) stvara novi objekt iz bitova izvornog objekta. Oba tipa moraju biti jednake veličine i trivijalno kopirljiva; to nije numerička pretvorba ni pristup izvoru putem aliasa.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <bit>
template<class To, class From>
constexpr To std::bit_cast(const From& from) noexcept;
std::bit_cast<To>(from)std::bit_cast iz zaglavlja <bit> vraća novi objekt tipa To. Bitovi njegova prikaza vrijednosti odgovaraju bitovima objektnog prikaza objekta from. Ne izvodi numeričku pretvorbu i ne stvara referencu na izvor. Tip From obično se izvodi.
Poziv zahtijeva sizeof(To) == sizeof(From), a oba tipa moraju biti trivijalno kopirljiva. Ti uvjeti sami po sebi ne jamče sigurnost proizvoljnih bitnih uzoraka: rezultat mora predstavljati valjanu vrijednost odredišnog tipa. Bitovi za popunu rezultata nisu specificirani; izbjegavajte neinicijalizirane podatke i prijenos popune u bitove vrijednosti.
Funkcija je noexcept. Deklaracija constexpr ne znači da se svaki poziv može izračunati tijekom kompilacije. Primjer upotrebljava unsigned char i std::byte kako bi prikazao takvu pretvorbu bez pretpostavki o redoslijedu bajtova ili formatu brojeva s pomičnim zarezom.
Ovaj se unos odnosi na C++23. Povezani dokument razvojni je radni nacrt, a ne zamrznuto izdanje C++23; njegova novija pravila ne smiju se automatski primjenjivati na C++23. Oznaka prevoditelja u repozitoriju ne potvrđuje kompatibilnost produkcijskog okruženja tijekom izvođenja.
Primjeri
#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';
}
Rezultat
42
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.