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

CKTIS / C++

Suffixe `u` des littéraux entiers non signés

Le suffixe `u` ou `U` sélectionne un type entier non signé sans imposer sa largeur. `0u` et `1u` sont de type `unsigned int` ; une valeur plus grande peut exiger un type plus large.

Version : ISO C++23; implementation support may vary

Syntaxe

integer-literal ::= (binary-literal | octal-literal | decimal-literal | hexadecimal-literal) integer-suffix?
unsigned-suffix ::= u | U
Examples: 0u, 1U, 0b101u, 077u, 0xFFU, 42ul, 42lu, 42ull, 42llu, 42uz, 42zu

En C++23, u ou U s’écrit juste après les chiffres d’un littéral entier. Le suffixe ne modifie pas la valeur et fonctionne en décimal, en binaire, en octal et en hexadécimal. Employé seul, il sélectionne le premier type capable de représenter la valeur : unsigned int, unsigned long, puis unsigned long long. Si aucun ne convient, l’implémentation peut utiliser un type entier étendu non signé approprié. Si aucun type autorisé ne convient, le programme est mal formé : le littéral n’est pas tronqué.

0u et 1u sont toujours de type unsigned int ; 0 et 1 sans suffixe sont de type int. ul commence la recherche à unsigned long, ull sélectionne unsigned long long parmi les types standard, et uz donne std::size_t en C++23 si la valeur est représentable. u peut aussi suivre l’autre composant du suffixe, comme dans lu, llu ou zu.

Les constantes du FNV 32 bits, 2166136261u et 16777619u, sont toutes deux de type unsigned int si ce type fait 32 bits. Sur d’autres implémentations, le choix dépend des plages de valeurs. Le suffixe ne signifie pas std::uint32_t : c’est un alias facultatif de <cstdint> pour un type entier non signé d’exactement 32 bits, sans bits de bourrage. Si tu as besoin d’un objet de ce type exact et que l’alias est disponible, écris par exemple std::uint32_t offset{2166136261u};. Le type de l’objet ne change pas celui du littéral d’initialisation.

Le type du littéral influe sur la déduction avec auto, la résolution de surcharge et les conversions dans les expressions. Par exemple, -1 < 1u vaut false : -1 est converti en unsigned int et devient la valeur maximale de ce type. N’ajoute pas u uniquement pour faire taire un avertissement sur le mélange de types signés et non signés.

Exemples

#include <iostream>
#include <type_traits>

constexpr const char* kind(int) { return "int"; }
constexpr const char* kind(unsigned int) { return "unsigned int"; }

int main() {
    auto zero = 0u;
    static_assert(std::is_same_v<decltype(zero), unsigned int>);
    static_assert(std::is_same_v<decltype(1u), unsigned int>);

    std::cout << kind(1) << '\n'
              << kind(1u) << '\n';
}

Résultat

int
unsigned int

Les assertions vérifient le type déduit par `auto` à partir de `0u` et le type de `1u`. `kind(1)` et `kind(1u)` sélectionnent des surcharges différentes, car le type correspond exactement dans chaque cas.

Leçons associées

  • C++ · Leçon 7 · Avancé · Version : 3

Sources