CKTIS / C++
std::byte — un byte senza semantica numerica
std::byte di <cstddef> rappresenta dati grezzi in byte. È un tipo enumerativo distinto, non un alias di unsigned char. Supporta le operazioni bit a bit, ma non l’aritmetica ordinaria né le conversioni implicite a tipi interi.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <cstddef>
std::byte b{0x2A};
auto masked = b & std::byte{0x0F};
auto value = std::to_integer<unsigned int>(masked);std::byte è dichiarato in <cstddef>, nello spazio dei nomi std, come enum class byte : unsigned char {};. Usalo quando un valore rappresenta dati grezzi in byte, anziché un carattere di testo o un numero destinato ai calcoli. È un tipo distinto, non un alias di unsigned char.
La dichiarazione std::byte b{0x2A}; inizializza direttamente un byte a partire da un intero. Questa inizializzazione richiede una conversione non restrittiva al tipo sottostante. La dichiarazione std::byte b = 42; non è valida: non esiste una conversione implicita da un intero. Per la conversione inversa, procedi esplicitamente, per esempio con std::to_integer<unsigned int>(b); l’argomento del template deve essere un tipo intero.
Agli operatori binari &, |, ^, << e >> corrispondono gli operatori di assegnazione composta &=, |=, ^=, <<= e >>=. È disponibile anche l’operatore unario di complemento bit a bit ~, che non ha una forma di assegnazione composta. Tutte queste operazioni sono constexpr e noexcept. Il numero di posizioni dello scorrimento deve essere di tipo intero. L’aritmetica ordinaria, come b + b o ++b, non è supportata.
L’esempio applica la maschera 0x0F a 0x2A, lasciando il valore 10. Prima della stampa, il risultato viene convertito con std::to_integer<unsigned int>(low); la libreria non fornisce un operatore di inserimento diretto per scrivere std::byte in std::cout.
Esempi
#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';
}
Risultato
10
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.