CKTIS / C++
std::bit_cast — einen Wert aus einer Bitdarstellung erzeugen
std::bit_cast<To>(from) erzeugt aus den Bits des Quellobjekts ein neues Objekt. Beide Typen müssen gleich groß und trivial kopierbar sein; es handelt sich weder um eine numerische Konvertierung noch um einen Zugriff auf die Quelle über einen Alias.
Version: 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 aus <bit> gibt ein neues Objekt des Typs To zurück. Die Bits seiner Wertdarstellung entsprechen den Bits der Objektdarstellung von from. Die Funktion führt keine numerische Konvertierung aus und erzeugt keine Referenz auf die Quelle. From wird normalerweise abgeleitet.
Der Aufruf setzt sizeof(To) == sizeof(From) voraus; außerdem müssen beide Typen trivial kopierbar sein. Diese Bedingungen allein machen beliebige Bitmuster nicht sicher: Das Ergebnis muss einen gültigen Wert des Zieltyps darstellen. Die Padding-Bits des Ergebnisses sind nicht spezifiziert; vermeide nicht initialisierte Daten und die Übertragung von Padding in Wertbits.
Die Funktion ist noexcept. Die Deklaration constexpr bedeutet nicht, dass jeder Aufruf zur Compile-Zeit ausgewertet werden kann. Das Beispiel verwendet unsigned char und std::byte, um eine solche Konvertierung ohne Annahmen über Byte-Reihenfolge oder Gleitkommaformat zu zeigen.
Dieser Eintrag bezieht sich auf C++23. Das verlinkte Dokument ist ein fortlaufend weiterentwickelter Arbeitsentwurf und keine eingefrorene C++23-Ausgabe; seine neueren Regeln dürfen nicht automatisch auf C++23 übertragen werden. Ein Compiler-Flag im Repository bestätigt nicht die Laufzeitkompatibilität der Produktionsumgebung.
Beispiele
#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';
}
Ergebnis
42
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.