Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::bit_cast — tworzenie wartości z reprezentacji bitowej

std::bit_cast<To>(from) tworzy nowy obiekt na podstawie bitów obiektu źródłowego. Typy muszą mieć jednakowy rozmiar i być trywialnie kopiowalne; nie jest to konwersja liczbowa ani dostęp do źródła przez alias.

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

Składnia

#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 nagłówka <bit> zwraca nowy obiekt typu To. Bity jego reprezentacji wartości odpowiadają bitom reprezentacji obiektowej from. Nie wykonuje konwersji liczbowej i nie tworzy referencji do źródła. Typ From jest zwykle dedukowany.

Wywołanie wymaga sizeof(To) == sizeof(From) oraz trywialnej kopiowalności obu typów. Samo spełnienie tych warunków nie gwarantuje bezpieczeństwa dowolnego wzorca bitów: wynik musi reprezentować prawidłową wartość typu docelowego. Bity dopełnienia wyniku są nieokreślone; unikaj niezainicjalizowanych danych i przenoszenia dopełnienia do bitów wartości.

Funkcja jest noexcept. Deklaracja constexpr nie oznacza, że każde wywołanie można obliczyć podczas kompilacji. Przykład używa unsigned char i std::byte, aby pokazać taką konwersję bez założeń o kolejności bajtów lub formacie zmiennoprzecinkowym.

Zakres wpisu to C++23. Podlinkowany dokument jest rozwijanym szkicem standardu, a nie zamrożoną wersją C++23; nie należy automatycznie przenosić jego nowszych reguł na C++23. Ustawienie flagi kompilatora w repozytorium nie potwierdza zgodności środowiska produkcyjnego.

Przykłady

#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';
}

Wynik

42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła