CKTIS / C
Límites y anchuras de enteros en <stdint.h>
Las macros de <stdint.h> describen los rangos y las anchuras en bits de los tipos enteros. Permiten comprobar la portabilidad y rechazar cálculos demasiado grandes antes de realizarlos. C23 añade las macros terminadas en _WIDTH.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#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> proporciona constantes utilizables en #if: _MIN y _MAX indican límites inclusivos; C23 añade _WIDTH para la anchura en bits, incluido el signo pero sin los bits de relleno. Para una anchura W, el rango con signo es −2^(W−1)…2^(W−1)−1 y el rango sin signo es 0…2^W−1. Las familias UINT no tienen macros de mínimo. Sin embargo, si SIG_ATOMIC_MIN, WCHAR_MIN o WINT_MIN se define para un tipo sin signo, la macro correspondiente vale 0.
Para cada N = 8, 16, 32, 64, los patrones de sintaxis abarcan todos los símbolos enumerados. INTN_MIN, INTN_MAX, INTN_WIDTH, UINTN_MAX y UINTN_WIDTH describen exactamente N bits sin relleno; estos tipos y macros son opcionales. Las familias INT_LEASTN_*/UINT_LEASTN_* describen los tipos más pequeños con al menos N bits; INT_FASTN_*/UINT_FASTN_* describen los tipos normalmente más rápidos con al menos N bits, pero no necesariamente los más rápidos para cada tarea. Ambas familias son obligatorias para estos valores de N y pueden tener mayor anchura.
INTPTR_MIN, INTPTR_MAX, INTPTR_WIDTH y UINTPTR_MAX, UINTPTR_WIDTH describen los tipos opcionales intptr_t/uintptr_t, que permiten convertir void * a entero y de vuelta conservando la igualdad. INTMAX_MIN, INTMAX_MAX, INTMAX_WIDTH, UINTMAX_MAX y UINTMAX_WIDTH describen los tipos obligatorios intmax_t/uintmax_t; la garantía de que tienen el mayor rango presenta excepciones para los tipos de precisión exacta en bits y ciertos tipos extendidos más anchos.
PTRDIFF_MIN, PTRDIFF_MAX, PTRDIFF_WIDTH describen ptrdiff_t (diferencias entre punteros); SIZE_MAX, SIZE_WIDTH describen size_t (tamaños). Las ternas SIG_ATOMIC_MIN/SIG_ATOMIC_MAX/SIG_ATOMIC_WIDTH, WCHAR_MIN/WCHAR_MAX/WCHAR_WIDTH y WINT_MIN/WINT_MAX/WINT_WIDTH describen, respectivamente, sig_atomic_t, wchar_t y wint_t. No presupongas que tengan signo o que sean sin signo. <stdint.h> no tiene por qué declarar estos tipos procedentes de otros encabezados; un entorno independiente puede omitir algunos.
Comprueba las macros opcionales con #ifdef. El ejemplo comprueba count <= SIZE_MAX / size antes de multiplicar, lo que también evita la división por cero. Un resultado positivo solo significa que el producto es representable, no que la asignación de memoria vaya a tener éxito.
Identificadores de referencia incluidos en esta entrada: 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.
Ejemplos
#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;
}
Resultado
small: 1 overflow: 0
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.