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.