WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::byte — ein Byte ohne Zahlenbedeutung

std::byte aus <cstddef> dient zur Darstellung roher Byte-Daten. Es ist ein eigenständiger Aufzählungstyp und kein Alias für unsigned char. Es unterstützt bitweise Operationen, jedoch keine gewöhnliche Arithmetik oder implizite Konvertierungen zu Ganzzahltypen.

Version: 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 ist in <cstddef> im Namensraum std als enum class byte : unsigned char {}; deklariert. Verwende es, wenn ein Wert rohe Byte-Daten darstellt und weder ein Textzeichen noch eine Zahl für Berechnungen ist. Es ist ein eigenständiger Typ und kein Alias für unsigned char.

Die Deklaration std::byte b{0x2A}; initialisiert ein Byte direkt mit einer Ganzzahl. Diese Initialisierung erfordert eine nicht verengende Konvertierung zum zugrunde liegenden Typ. Die Deklaration std::byte b = 42; ist ungültig: Es gibt keine implizite Konvertierung von einer Ganzzahl. Konvertiere explizit zurück, zum Beispiel mit std::to_integer<unsigned int>(b); das Template-Argument muss ein Ganzzahltyp sein.

Zu den binären Operatoren &, |, ^, << und >> gehören die zusammengesetzten Zuweisungsoperatoren &=, |=, ^=, <<= und >>=. Auch der unäre Operator ~ zur bitweisen Negation wird unterstützt, hat aber keine zusammengesetzte Zuweisungsform. Alle diese Operationen sind constexpr und noexcept. Ein Verschiebungswert muss einen Ganzzahltyp haben. Gewöhnliche Arithmetik wie b + b oder ++b wird nicht unterstützt.

Das Beispiel wendet die Maske 0x0F auf 0x2A an und erhält den Wert 10. Vor der Ausgabe wird das Ergebnis mit std::to_integer<unsigned int> konvertiert; die Bibliothek stellt keinen direkten Einfügeoperator bereit, um std::byte in std::cout auszugeben.

Beispiele

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

Ergebnis

10

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.

Quellen