KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::bit_cast — een waarde maken op basis van een bitrepresentatie

std::bit_cast<To>(from) maakt een nieuw object op basis van de bits van het bronobject. Beide typen moeten even groot en triviaal kopieerbaar zijn; dit is geen numerieke conversie en geeft geen toegang tot de bron via een alias.

Versie: 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 uit <bit> retourneert een nieuw object van type To. De bits van de waarderepresentatie ervan komen overeen met de bits van de objectrepresentatie van from. De functie voert geen numerieke conversie uit en maakt geen verwijzing naar de bron. From wordt doorgaans afgeleid.

De aanroep vereist sizeof(To) == sizeof(From) en beide typen moeten triviaal kopieerbaar zijn. Deze voorwaarden alleen maken willekeurige bitpatronen niet veilig: het resultaat moet een geldige waarde van het doeltype voorstellen. De paddingbits van het resultaat zijn niet gespecificeerd; vermijd niet-geïnitialiseerde gegevens en het overbrengen van padding naar waardebits.

De functie is noexcept. De declaratie constexpr betekent niet dat elke aanroep tijdens het compileren kan worden geëvalueerd. Het voorbeeld gebruikt unsigned char en std::byte om deze conversie te laten zien zonder aannames over bytevolgorde of floating-pointformaat.

Dit item is gericht op C++23. Het gekoppelde document is een evoluerend werkdocument, geen vastgelegde C++23-editie; nieuwere regels daarin mogen niet automatisch op C++23 worden toegepast. Een compileroptie in een repository bevestigt niet dat de productieomgeving tijdens uitvoering compatibel is.

Voorbeelden

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

Resultaat

42

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen