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.