CKTIS / C++
std::byte — un octet sans sémantique numérique
std::byte de <cstddef> représente des données brutes en octets. C’est un type énuméré distinct, et non un alias de unsigned char. Il prend en charge les opérations bit à bit, mais pas l’arithmétique ordinaire ni les conversions implicites vers des types entiers.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstddef>
std::byte b{0x2A};
auto masked = b & std::byte{0x0F};
auto value = std::to_integer<unsigned int>(masked);std::byte est déclaré dans <cstddef>, dans l’espace de noms std, sous la forme enum class byte : unsigned char {};. Utilisez-le lorsqu’une valeur représente des données brutes en octets, plutôt qu’un caractère de texte ou un nombre destiné aux calculs. C’est un type distinct, et non un alias de unsigned char.
La déclaration std::byte b{0x2A}; initialise directement un octet à partir d’un entier. Cette initialisation exige une conversion sans réduction vers le type sous-jacent. La déclaration std::byte b = 42; est invalide : il n’existe pas de conversion implicite depuis un entier. Pour effectuer la conversion inverse, utilisez une conversion explicite, par exemple std::to_integer<unsigned int>(b) ; son argument de modèle doit être un type entier.
Aux opérateurs binaires &, |, ^, << et >> correspondent les opérateurs d’affectation composée &=, |=, ^=, <<= et >>=. L’opérateur unaire de complément bit à bit ~ est également disponible, mais n’a pas de forme d’affectation composée. Toutes ces opérations sont constexpr et noexcept. Le nombre de positions du décalage doit être de type entier. Les opérations arithmétiques ordinaires comme b + b ou ++b ne sont pas prises en charge.
L’exemple applique le masque 0x0F à 0x2A, ce qui laisse la valeur 10. Avant l’affichage, le résultat est converti avec std::to_integer<unsigned int> ; la bibliothèque ne fournit pas d’opérateur d’insertion direct pour écrire std::byte dans std::cout.
Exemples
#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';
}
Résultat
10
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.