Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::uint8_t — type entier non signé sur 8 bits

std::uint8_t, fourni par <cstdint>, est un alias facultatif pour un type entier non signé de exactement 8 bits, dont la plage va de 0 à 255. Lors des calculs, il subit les promotions entières et peut se comporter comme un caractère à l’affichage.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <cstdint>
std::uint8_t value{42};

std::uint8_t, déclaré dans <cstdint>, est un alias pour un type entier non signé de exactement 8 bits, sans bits de remplissage. Il stocke des valeurs de 0 à 255. Cet alias ne crée pas un nouveau type distinct. Il est utile pour représenter des valeurs numériques sur 8 bits, par exemple les champs d’un protocole binaire.

Ce type est facultatif : une implémentation le fournit si elle dispose d’un type entier approprié de largeur exacte et sans bits de remplissage. Ne supposez pas qu’il existe sur toutes les plateformes. Si au moins 8 bits suffisent, envisagez std::uint_least8_t. L’URL de la norme fournie renvoie à un projet de travail évolutif, et non à une édition figée de C++23.

Dans value + 1, la valeur de std::uint8_t est promue en int. Ainsi, si value vaut 255, le résultat est 256 et non 0. Seule la conversion de ce résultat en std::uint8_t donne 0 : une conversion entière vers ce type réduit la valeur modulo 256. Ne confondez pas la promotion pendant un calcul avec la conversion ultérieure de son résultat.

std::uint8_t peut être un alias de unsigned char. Par conséquent, l’expression directe std::cout << value peut afficher un caractère plutôt qu’un nombre. Utilisez static_cast<unsigned int>(value) pour forcer un affichage numérique. L’exemple présente la valeur initiale, le résultat de l’addition et celui d’une conversion explicite vers le type 8 bits.

Exemples

#include <cstdint>
#include <iostream>

int main() {
    std::uint8_t value{255};
    const auto sum = value + 1;
    const auto wrapped = static_cast<std::uint8_t>(sum);

    std::cout << static_cast<unsigned int>(value) << '\n';
    std::cout << sum << '\n';
    std::cout << static_cast<unsigned int>(wrapped) << '\n';
}

Résultat

255
256
0

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.

Sources