CKTIS / C++
std::bit_cast — ustvarjanje vrednosti iz bitne predstavitve
std::bit_cast<To>(from) ustvari nov objekt iz bitov izvornega objekta. Oba tipa morata biti enako velika in trivialno kopirljiva; to ni številska pretvorba niti dostop do vira prek vzdevka.
Različica: 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 glave <bit> vrne nov objekt tipa To. Biti njegove vrednostne predstavitve ustrezajo bitom objektne predstavitve objekta from. Ne izvaja številske pretvorbe in ne ustvari reference na vir. Tip From se običajno izpelje.
Klic zahteva sizeof(To) == sizeof(From) in oba tipa morata biti trivialno kopirljiva. Ti pogoji sami po sebi ne zagotavljajo varnosti poljubnih bitnih vzorcev: rezultat mora predstavljati veljavno vrednost ciljnega tipa. Biti za polnjenje rezultata niso določeni; izogibaj se neinicializiranim podatkom in prenosu polnjenja v vrednostne bite.
Funkcija je noexcept. Deklaracija constexpr ne pomeni, da je mogoče vsak klic ovrednotiti med prevajanjem. Primer uporablja unsigned char in std::byte, da prikaže takšno pretvorbo brez predpostavk o vrstnem redu bajtov ali zapisu števil s plavajočo vejico.
Ta vnos se nanaša na C++23. Povezani dokument je razvijajoči se delovni osnutek in ne zamrznjena izdaja C++23; njegovih novejših pravil se ne sme samodejno uporabljati za C++23. Zastavica prevajalnika v repozitoriju ne potrjuje združljivosti produkcijskega izvajalnega okolja.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.