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

CKTIS / C++

std::int8_t — un entier signé sur exactement 8 bits

std::int8_t de <cstdint> est un alias facultatif pour un type entier signé comportant exactement 8 bits et aucun bit de remplissage. Il stocke des valeurs de -128 à 127. Les calculs suivent les règles de promotion des entiers ; une conversion explicite en int est utile pour afficher sa valeur numérique.

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

Syntaxe

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

std::int8_t, fourni par <cstdint>, est un alias d’un type existant et non un nouveau type distinct. Il comporte exactement 8 bits, aucun bit de remplissage et couvre les valeurs de -128 à 127. Il est facultatif : une implémentation doit le fournir si elle dispose d’un type entier adapté. Après inclusion de l’en-tête, la macro INT8_MAX permet d’en vérifier la disponibilité.

Utilisez-le lorsqu’une largeur exacte est nécessaire. Si au moins 8 bits suffisent, choisissez std::int_least8_t ; std::uint8_t, en revanche, est un type non signé facultatif dont les valeurs vont de 0 à 255. std::int8_t peut être un alias de signed char. En C++23, l’insérer directement dans std::cout peut donc faire traiter sa valeur comme un caractère ; static_cast<int>(value) demande sans ambiguïté un affichage numérique.

Dans value + 7, la valeur std::int8_t est promue en int, le résultat est donc lui aussi de type int. Vérifiez la plage avant de stocker à nouveau le résultat : une conversion explicite ne signale pas les valeurs hors plage. En C++23, convertir un entier vers ce type produit la valeur congrue modulo 256, au lieu de la limiter à la borne la plus proche de la plage.

L’exemple stocke 120, calcule 127 en int, puis stocke à nouveau le résultat représentable. La sortie attendue est 120 127 127, suivie d’un saut de ligne. Ce contenu porte sur C++23 ; le projet de norme fourni évolue et ne constitue pas une édition C++23 figée. Le mode de compilation du dépôt ne garantit pas le comportement en environnement de production.

Exemples

#include <cstdint>
#include <iostream>

#ifndef INT8_MAX
#error "This example requires std::int8_t"
#else
int main() {
    std::int8_t value{120};
    int sum = value + 7;
    std::int8_t result{static_cast<std::int8_t>(sum)};
    std::cout << static_cast<int>(value) << ' '
              << sum << ' ' << static_cast<int>(result) << '\n';
}
#endif

Résultat

120 127 127

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