WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

Ganzzahlgrenzen und -breiten in <stdint.h>

Makros aus <stdint.h> beschreiben Wertebereiche und Bitbreiten von Ganzzahltypen. Sie helfen, Portabilität zu prüfen und zu große Berechnungen vor ihrer Ausführung abzuweisen. C23 ergänzt Makros mit der Endung _WIDTH.

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

Syntax

#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> stellt Konstanten bereit, die in #if verwendet werden können: _MIN und _MAX geben einschließlich geltende Grenzen an; C23 ergänzt _WIDTH für die Bitbreite einschließlich Vorzeichen, aber ohne Füllbits. Bei Breite W reicht der vorzeichenbehaftete Bereich von −2^(W−1) bis 2^(W−1)−1, der vorzeichenlose von 0 bis 2^W−1. Die UINT-Familien haben keine Minimum-Makros. Ist jedoch SIG_ATOMIC_MIN, WCHAR_MIN oder WINT_MIN für einen vorzeichenlosen Typ definiert, hat das jeweilige Makro den Wert 0.

Für jedes N = 8, 16, 32, 64 decken die Syntaxmuster alle aufgeführten Symbole ab. INTN_MIN, INTN_MAX, INTN_WIDTH, UINTN_MAX und UINTN_WIDTH beschreiben genau N Bits ohne Füllbits; diese Typen und Makros sind optional. Die Familien INT_LEASTN_*/UINT_LEASTN_* bezeichnen die kleinsten Typen mit mindestens N Bits. INT_FASTN_*/UINT_FASTN_* bezeichnen normalerweise die schnellsten Typen mit mindestens N Bits, aber nicht unbedingt die schnellsten für jede Aufgabe. Beide Familien sind für diese N erforderlich und können breiter sein.

INTPTR_MIN, INTPTR_MAX, INTPTR_WIDTH sowie UINTPTR_MAX, UINTPTR_WIDTH beschreiben die optionalen Typen intptr_t/uintptr_t, mit denen sich ein void * in eine Ganzzahl und zurück umwandeln lässt, wobei die Gleichheit erhalten bleibt. INTMAX_MIN, INTMAX_MAX, INTMAX_WIDTH, UINTMAX_MAX und UINTMAX_WIDTH beschreiben die erforderlichen Typen intmax_t/uintmax_t; die Garantie ihres größtmöglichen Wertebereichs hat Ausnahmen für bitgenaue Typen und bestimmte breitere erweiterte Typen.

PTRDIFF_MIN, PTRDIFF_MAX, PTRDIFF_WIDTH beschreiben ptrdiff_t (Zeigerdifferenzen); SIZE_MAX, SIZE_WIDTH beschreiben size_t (Größen). Die Dreiergruppen SIG_ATOMIC_MIN/SIG_ATOMIC_MAX/SIG_ATOMIC_WIDTH, WCHAR_MIN/WCHAR_MAX/WCHAR_WIDTH und WINT_MIN/WINT_MAX/WINT_WIDTH beschreiben jeweils sig_atomic_t, wchar_t und wint_t. Gehe nicht von deren Vorzeichenbehaftung aus. <stdint.h> muss diese Typen aus anderen Headern nicht deklarieren; in einer freistehenden Umgebung können einige fehlen.

Prüfe optionale Makros mit #ifdef. Das Beispiel prüft vor der Multiplikation count <= SIZE_MAX / size und schützt damit auch vor Division durch null. Ein positives Ergebnis bedeutet nur, dass das Produkt darstellbar ist, nicht, dass eine Speicherallokation gelingt.

In diesem Eintrag behandelte Referenzbezeichner: 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.

Beispiele

#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;
}

Ergebnis

small: 1
overflow: 0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen