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

CKTIS / C++

std::uint16_t — un entier non signé d’exactement 16 bits

std::uint16_t, défini dans <cstdint>, est un alias facultatif pour un type entier non signé d’exactement 16 bits, dont la plage va de 0 à 65535. Il est utile lorsqu’une largeur exacte est nécessaire, mais ne garantit pas une taille de deux octets sur toutes les plateformes.

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

Syntaxe

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

std::uint16_t, disponible après #include <cstdint>, est un alias d’un type entier non signé existant, et non un nouveau type distinct. Il comporte exactement 16 bits, sans bits de bourrage, et représente des valeurs de 0 à 65535. Ne supposez pas qu’il est toujours un alias de unsigned short.

Cet alias est facultatif : une implémentation le fournit si elle prend en charge un type entier de la largeur correspondante et sans bits de bourrage. Si au moins 16 bits suffisent, choisissez std::uint_least16_t. Exactement 16 bits ne signifie pas nécessairement que sizeof(std::uint16_t) == 2, car sizeof mesure les octets C++, qui ne contiennent pas forcément 8 bits.

La conversion d’un entier en std::uint16_t produit sa valeur modulo 65536 ; ainsi, static_cast<std::uint16_t>(65536UL) produit 0. Cela ne signifie pas que toutes les opérations sur des opérandes de ce type utilisent l’arithmétique sur 16 bits : les promotions entières peuvent d’abord modifier le type des opérandes, souvent en int. Pour les calculs qui exigent une plage plus grande, choisissez explicitement un type suffisamment large.

L’exemple montre la valeur maximale et le résultat d’une conversion explicite. Les conversions vers unsigned long garantissent un affichage numérique, quel que soit le type sous-jacent de l’alias. Le code est destiné à être compilé en C++23 ; choisir ce mode à lui seul ne confirme pas son fonctionnement dans un environnement d’exécution de production.

Exemples

#include <cstdint>
#include <iostream>

int main() {
    constexpr std::uint16_t maximum{65535};
    constexpr auto wrapped = static_cast<std::uint16_t>(65536UL);
    static_assert(wrapped == 0);

    std::cout << static_cast<unsigned long>(maximum) << '\n'
              << static_cast<unsigned long>(wrapped) << '\n';
}

Résultat

65535
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