Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::bit_cast — vytvorenie hodnoty z bitovej reprezentácie

std::bit_cast<To>(from) vytvorí nový objekt z bitov zdrojového objektu. Oba typy musia mať rovnakú veľkosť a byť triviálne kopírovateľné; nejde o číselnú konverziu ani o prístup k zdroju cez alias.

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

Syntax

#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> vracia nový objekt typu To. Bity jeho hodnotovej reprezentácie zodpovedajú bitom objektovej reprezentácie objektu from. Nevykonáva číselnú konverziu a nevytvára referenciu na zdroj. Typ From sa zvyčajne odvodí.

Volanie vyžaduje sizeof(To) == sizeof(From) a oba typy musia byť triviálne kopírovateľné. Tieto podmienky samy osebe nezaručujú bezpečnosť ľubovoľných bitových vzorov: výsledok musí predstavovať platnú hodnotu cieľového typu. Výplňové bity výsledku nie sú špecifikované; vyhýbajte sa neinicializovaným údajom a prenosu výplne do hodnotových bitov.

Funkcia je noexcept. Deklarácia constexpr neznamená, že každé volanie možno vyhodnotiť pri kompilácii. Príklad používa unsigned char a std::byte, aby ukázal takúto konverziu bez predpokladov o poradí bajtov alebo formáte čísel s pohyblivou rádovou čiarkou.

Tento záznam sa týka C++23. Prepojený dokument je priebežne vyvíjaný pracovný návrh, nie zmrazené vydanie C++23; jeho novšie pravidlá sa nesmú automaticky uplatňovať na C++23. Príznak kompilátora v repozitári nepotvrdzuje kompatibilitu produkčného behového prostredia.

Prí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ýsledok

42

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje