Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

Limiti e larghezze degli interi in <stdint.h>

Le macro di <stdint.h> descrivono gli intervalli e le larghezze in bit dei tipi interi. Consentono di verificare la portabilità e rifiutare calcoli troppo grandi prima di eseguirli. C23 aggiunge le macro che terminano in _WIDTH.

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

Sintassi

#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> fornisce costanti utilizzabili in #if: _MIN e _MAX indicano i limiti inclusivi; C23 aggiunge _WIDTH per la larghezza in bit, compreso il segno ma esclusi i bit di padding. Per una larghezza W, l’intervallo con segno è −2^(W−1)…2^(W−1)−1 e quello senza segno è 0…2^W−1. Le famiglie UINT non hanno macro per il minimo. Se però SIG_ATOMIC_MIN, WCHAR_MIN o WINT_MIN è definita per un tipo senza segno, la macro corrispondente vale 0.

Per ciascun N = 8, 16, 32, 64, gli schemi sintattici coprono tutti i simboli elencati. INTN_MIN, INTN_MAX, INTN_WIDTH, UINTN_MAX e UINTN_WIDTH descrivono esattamente N bit senza padding; questi tipi e macro sono opzionali. Le famiglie INT_LEASTN_*/UINT_LEASTN_* descrivono i tipi più piccoli con almeno N bit; INT_FASTN_*/UINT_FASTN_* descrivono i tipi di solito più veloci con almeno N bit, ma non necessariamente i più veloci per ogni attività. Entrambe le famiglie sono richieste per questi valori di N e possono essere più larghe.

INTPTR_MIN, INTPTR_MAX, INTPTR_WIDTH e UINTPTR_MAX, UINTPTR_WIDTH descrivono i tipi opzionali intptr_t/uintptr_t, che permettono una conversione di andata e ritorno da void * a intero preservando l’uguaglianza. INTMAX_MIN, INTMAX_MAX, INTMAX_WIDTH, UINTMAX_MAX e UINTMAX_WIDTH descrivono i tipi richiesti intmax_t/uintmax_t; la garanzia dell’intervallo più ampio prevede eccezioni per i tipi a precisione in bit e alcuni tipi estesi più larghi.

PTRDIFF_MIN, PTRDIFF_MAX, PTRDIFF_WIDTH descrivono ptrdiff_t (differenze tra puntatori); SIZE_MAX, SIZE_WIDTH descrivono size_t (dimensioni). Le terne SIG_ATOMIC_MIN/SIG_ATOMIC_MAX/SIG_ATOMIC_WIDTH, WCHAR_MIN/WCHAR_MAX/WCHAR_WIDTH e WINT_MIN/WINT_MAX/WINT_WIDTH descrivono rispettivamente sig_atomic_t, wchar_t e wint_t. Non dare per scontato che siano con o senza segno. <stdint.h> non è tenuto a dichiarare questi tipi provenienti da altri header; un ambiente freestanding può ometterne alcuni.

Controlla le macro opzionali con #ifdef. L’esempio verifica count <= SIZE_MAX / size prima della moltiplicazione, proteggendo anche dalla divisione per zero. Un risultato positivo significa soltanto che il prodotto è rappresentabile, non che l’allocazione di memoria riuscirà.

Identificatori di riferimento trattati in questa voce: 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.

Esempi

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

Risultato

small: 1
overflow: 0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti