CKTIS / C
Hranice a šírky celých čísel v <stdint.h>
Makrá z <stdint.h> opisujú rozsahy a bitové šírky celočíselných typov. Umožňujú overiť prenositeľnosť a odmietnuť príliš veľké výpočty ešte pred ich vykonaním. C23 pridáva makrá končiace sa na _WIDTH.
Verzia: 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> poskytuje konštanty použiteľné v #if: _MIN a _MAX udávajú vrátane hraničnej hodnoty; C23 pridáva _WIDTH pre bitovú šírku, ktorá zahŕňa znamienko, ale nezahŕňa výplňové bity. Pri šírke W je rozsah so znamienkom −2^(W−1)…2^(W−1)−1 a bez znamienka 0…2^W−1. Rodiny UINT nemajú makrá minima. Ak je však SIG_ATOMIC_MIN, WCHAR_MIN alebo WINT_MIN definované pre typ bez znamienka, príslušné makro má hodnotu 0.
Pre každé N = 8, 16, 32, 64 pokrývajú vzory syntaxe všetky uvedené symboly. INTN_MIN, INTN_MAX, INTN_WIDTH, UINTN_MAX a UINTN_WIDTH opisujú presne N bitov bez výplne; tieto typy a makrá sú nepovinné. Rodiny INT_LEASTN_*/UINT_LEASTN_* opisujú najmenšie typy s aspoň N bitmi; INT_FASTN_*/UINT_FASTN_* opisujú zvyčajne najrýchlejšie typy s aspoň N bitmi, nie však nevyhnutne najrýchlejšie pre každú úlohu. Obe rodiny sú pre tieto hodnoty N povinné a môžu byť širšie.
INTPTR_MIN, INTPTR_MAX, INTPTR_WIDTH a UINTPTR_MAX, UINTPTR_WIDTH opisujú nepovinné typy intptr_t/uintptr_t, ktoré umožňujú previesť void * na celé číslo a späť pri zachovaní rovnosti. INTMAX_MIN, INTMAX_MAX, INTMAX_WIDTH, UINTMAX_MAX a UINTMAX_WIDTH opisujú povinné typy intmax_t/uintmax_t; záruka najväčšieho rozsahu má výnimky pre bitovo presné typy a niektoré širšie rozšírené typy.
PTRDIFF_MIN, PTRDIFF_MAX, PTRDIFF_WIDTH opisujú ptrdiff_t (rozdiely ukazovateľov); SIZE_MAX, SIZE_WIDTH opisujú size_t (veľkosti). Trojice SIG_ATOMIC_MIN/SIG_ATOMIC_MAX/SIG_ATOMIC_WIDTH, WCHAR_MIN/WCHAR_MAX/WCHAR_WIDTH a WINT_MIN/WINT_MAX/WINT_WIDTH opisujú postupne sig_atomic_t, wchar_t a wint_t. Nepredpokladajte ich znamienkovosť. <stdint.h> nemusí deklarovať tieto typy z iných hlavičiek; v prostredí freestanding môžu niektoré chýbať.
Nepovinné makrá kontrolujte pomocou #ifdef. Príklad pred násobením testuje count <= SIZE_MAX / size, čím zároveň chráni pred delením nulou. Kladný výsledok znamená iba to, že súčin možno reprezentovať, nie že alokácia pamäte uspeje.
Referenčné identifikátory zahrnuté v tomto hesle: 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.
Príklady
#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;
}
Výsledok
small: 1 overflow: 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.