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

CKTIS / C

Limites et largeurs des entiers dans <stdint.h>

Les macros de <stdint.h> décrivent les plages et les largeurs en bits des types entiers. Elles permettent de vérifier la portabilité et d’écarter les calculs trop grands avant de les effectuer. C23 ajoute les macros se terminant par _WIDTH.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdint.h>

/* Macro name patterns (substitute 8, 16, 32, or 64 for N):
   INTN_MIN, INTN_MAX, INTN_WIDTH
   UINTN_MAX, UINTN_WIDTH
   INT_LEASTN_MIN, INT_LEASTN_MAX, INT_LEASTN_WIDTH
   UINT_LEASTN_MAX, UINT_LEASTN_WIDTH
   INT_FASTN_MIN, INT_FASTN_MAX, INT_FASTN_WIDTH
   UINT_FASTN_MAX, UINT_FASTN_WIDTH

   Other macro names:
   INTPTR_MIN, INTPTR_MAX, INTPTR_WIDTH
   UINTPTR_MAX, UINTPTR_WIDTH
   INTMAX_MIN, INTMAX_MAX, INTMAX_WIDTH
   UINTMAX_MAX, UINTMAX_WIDTH
   PTRDIFF_MIN, PTRDIFF_MAX, PTRDIFF_WIDTH
   SIZE_MAX, SIZE_WIDTH
   SIG_ATOMIC_MIN, SIG_ATOMIC_MAX, SIG_ATOMIC_WIDTH
   WCHAR_MIN, WCHAR_MAX, WCHAR_WIDTH
   WINT_MIN, WINT_MAX, WINT_WIDTH
*/

<stdint.h> fournit des constantes utilisables dans #if : _MIN et _MAX donnent les bornes inclusives ; C23 ajoute _WIDTH pour la largeur en bits, signe compris mais sans les bits de remplissage. Pour une largeur W, la plage signée va de −2^(W−1) à 2^(W−1)−1, et la plage non signée de 0 à 2^W−1. Les familles UINT n’ont pas de macro de minimum. En revanche, si SIG_ATOMIC_MIN, WCHAR_MIN ou WINT_MIN est définie pour un type non signé, la macro correspondante vaut 0.

Pour chaque N = 8, 16, 32, 64, les formes de syntaxe couvrent tous les symboles listés. INTN_MIN, INTN_MAX, INTN_WIDTH, UINTN_MAX et UINTN_WIDTH décrivent exactement N bits sans remplissage ; ces types et macros sont facultatifs. Les familles INT_LEASTN_*/UINT_LEASTN_* décrivent les plus petits types d’au moins N bits ; INT_FASTN_*/UINT_FASTN_* désignent les types généralement les plus rapides d’au moins N bits, sans être nécessairement les plus rapides pour chaque tâche. Les deux familles sont obligatoires pour ces valeurs de N et peuvent être plus larges.

INTPTR_MIN, INTPTR_MAX, INTPTR_WIDTH ainsi que UINTPTR_MAX, UINTPTR_WIDTH décrivent les types facultatifs intptr_t/uintptr_t, qui permettent une conversion aller-retour de void * en entier en préservant l’égalité. INTMAX_MIN, INTMAX_MAX, INTMAX_WIDTH, UINTMAX_MAX et UINTMAX_WIDTH décrivent les types obligatoires intmax_t/uintmax_t ; la garantie de plage la plus grande comporte des exceptions pour les types à précision en bits et certains types étendus plus larges.

PTRDIFF_MIN, PTRDIFF_MAX, PTRDIFF_WIDTH décrivent ptrdiff_t (différences de pointeurs) ; SIZE_MAX, SIZE_WIDTH décrivent size_t (tailles). Les triplets SIG_ATOMIC_MIN/SIG_ATOMIC_MAX/SIG_ATOMIC_WIDTH, WCHAR_MIN/WCHAR_MAX/WCHAR_WIDTH et WINT_MIN/WINT_MAX/WINT_WIDTH décrivent respectivement sig_atomic_t, wchar_t et wint_t. Ne présumez pas de leur signe. <stdint.h> n’est pas tenu de déclarer ces types provenant d’autres en-têtes ; un environnement autonome peut en omettre certains.

Vérifiez les macros facultatives avec #ifdef. L’exemple teste count <= SIZE_MAX / size avant la multiplication, ce qui évite aussi une division par zéro. Un résultat positif signifie seulement que le produit est représentable, pas que l’allocation mémoire réussira.

Identifiants de référence couverts par cette entrée : INT8_MIN, INT8_MAX, INT8_WIDTH, UINT8_MAX, UINT8_WIDTH, INT_LEAST8_MIN, INT_LEAST8_MAX, INT_LEAST8_WIDTH, UINT_LEAST8_MAX, UINT_LEAST8_WIDTH, INT_FAST8_MIN, INT_FAST8_MAX, INT_FAST8_WIDTH, UINT_FAST8_MAX, UINT_FAST8_WIDTH, INT16_MIN, INT16_MAX, INT16_WIDTH, UINT16_MAX, UINT16_WIDTH, INT_LEAST16_MIN, INT_LEAST16_MAX, INT_LEAST16_WIDTH, UINT_LEAST16_MAX, UINT_LEAST16_WIDTH, INT_FAST16_MIN, INT_FAST16_MAX, INT_FAST16_WIDTH, UINT_FAST16_MAX, UINT_FAST16_WIDTH, INT32_MIN, INT32_MAX, INT32_WIDTH, UINT32_MAX, UINT32_WIDTH, INT_LEAST32_MIN, INT_LEAST32_MAX, INT_LEAST32_WIDTH, UINT_LEAST32_MAX, UINT_LEAST32_WIDTH, INT_FAST32_MIN, INT_FAST32_MAX, INT_FAST32_WIDTH, UINT_FAST32_MAX, UINT_FAST32_WIDTH, INT64_MIN, INT64_MAX, INT64_WIDTH, UINT64_MAX, UINT64_WIDTH, INT_LEAST64_MIN, INT_LEAST64_MAX, INT_LEAST64_WIDTH, UINT_LEAST64_MAX, UINT_LEAST64_WIDTH, INT_FAST64_MIN, INT_FAST64_MAX, INT_FAST64_WIDTH, UINT_FAST64_MAX, UINT_FAST64_WIDTH.

Exemples

#include <stddef.h>
#include <stdint.h>
#include <stdio.h>

static int product_fits(size_t count, size_t size)
{
    return size == 0 || count <= SIZE_MAX / size;
}

int main(void)
{
#ifdef UINT_LEAST8_WIDTH
    _Static_assert(UINT_LEAST8_WIDTH >= 8, "width too small");
#else
    _Static_assert(UINT_LEAST8_MAX >= 255, "range too small");
#endif
    printf("small: %d\n", product_fits(3, 4));
    printf("overflow: %d\n", product_fits(SIZE_MAX, 2));
    return 0;
}

Résultat

small: 1
overflow: 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