Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje