CKTIS / C++
std::byte — een byte zonder numerieke betekenis
std::byte uit <cstddef> stelt ruwe bytegegevens voor. Het is een afzonderlijk enumeratietype, geen alias voor unsigned char. Het ondersteunt bitsgewijze bewerkingen, maar geen gewone rekenkunde of impliciete conversies naar integer-typen.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cstddef>
std::byte b{0x2A};
auto masked = b & std::byte{0x0F};
auto value = std::to_integer<unsigned int>(masked);std::byte is in <cstddef> in de naamruimte std gedeclareerd als enum class byte : unsigned char {};. Gebruik het wanneer een waarde ruwe bytegegevens voorstelt, en niet een tekstteken of een getal om mee te rekenen. Het is een afzonderlijk type, geen alias voor unsigned char.
De declaratie std::byte b{0x2A}; initialiseert een byte rechtstreeks met een integer. Hiervoor is een niet-vernauwende conversie naar het onderliggende type vereist. De declaratie std::byte b = 42; is ongeldig: er bestaat geen impliciete conversie vanuit een integer. Converteer expliciet terug, bijvoorbeeld met std::to_integer<unsigned int>(b); het template-argument moet een integer-type zijn.
Bij de binaire operatoren &, |, ^, << en >> horen de samengestelde toewijzingsoperatoren &=, |=, ^=, <<= en >>=. De unaire operator ~ voor het bitsgewijze complement wordt ook ondersteund, maar heeft geen samengestelde toewijzingsvorm. Al deze bewerkingen zijn constexpr en noexcept. Het aantal bitposities waarover wordt verschoven, moet een integer-type hebben. Gewone rekenkunde zoals b + b of ++b wordt niet ondersteund.
Het voorbeeld past het masker 0x0F toe op 0x2A, waardoor de waarde 10 overblijft. Voordat het resultaat wordt afgedrukt, wordt het geconverteerd met std::to_integer<unsigned int>(low); de bibliotheek biedt geen directe invoegoperator om std::byte naar std::cout te schrijven.
Voorbeelden
#include <cstddef>
#include <iostream>
int main() {
constexpr std::byte value{0x2A};
constexpr std::byte mask{0x0F};
constexpr std::byte low = value & mask;
static_assert(std::to_integer<unsigned int>(low) == 10u);
std::cout << std::to_integer<unsigned int>(low) << '\n';
}
Resultaat
10
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.