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.