CKTIS / C++
std::bit_cast — vytvoření hodnoty z bitové reprezentace
std::bit_cast<To>(from) vytvoří nový objekt z bitů zdrojového objektu. Oba typy musí mít stejnou velikost a být triviálně kopírovatelné; nejde o číselnou konverzi ani o přístup ke zdroji přes alias.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <bit>
template<class To, class From>
constexpr To std::bit_cast(const From& from) noexcept;
std::bit_cast<To>(from)std::bit_cast z hlavičky <bit> vrací nový objekt typu To. Bity jeho hodnotové reprezentace odpovídají bitům objektové reprezentace objektu from. Neprovádí číselnou konverzi a nevytváří referenci ke zdroji. Typ From se obvykle odvodí.
Volání vyžaduje sizeof(To) == sizeof(From) a oba typy musí být triviálně kopírovatelné. Tyto podmínky samy o sobě nezaručují bezpečnost libovolných bitových vzorů: výsledek musí představovat platnou hodnotu cílového typu. Výplňové bity výsledku nejsou specifikovány; vyhýbejte se neinicializovaným datům a přenosu výplně do hodnotových bitů.
Funkce je noexcept. Deklarace constexpr neznamená, že lze každé volání vyhodnotit při překladu. Příklad používá unsigned char a std::byte, aby ukázal takovou konverzi bez předpokladů o pořadí bajtů nebo formátu čísel s plovoucí desetinnou čárkou.
Tento záznam se vztahuje k C++23. Odkazovaný dokument je průběžně vyvíjený pracovní návrh, nikoli zmrazené vydání C++23; jeho novější pravidla se nesmějí automaticky vztahovat na C++23. Příznak kompilátoru v repozitáři nepotvrzuje kompatibilitu produkčního běhového prostředí.
Příklady
#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';
}
Výsledek
42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.