CKTIS / C
Gehele-getalgrenzen en -breedtes in <stdint.h>
Macro's uit <stdint.h> beschrijven bereiken en bitbreedtes van gehele-getaltypen. Gebruik ze om portabiliteit te controleren en te grote berekeningen af te wijzen voordat ze worden uitgevoerd. C23 voegt macro's toe die eindigen op _WIDTH.
Versie: 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> levert constanten die in #if kunnen worden gebruikt: _MIN en _MAX geven inclusieve grenzen; C23 voegt _WIDTH toe voor de bitbreedte, inclusief het teken maar exclusief opvulbits. Bij breedte W loopt het bereik met teken van −2^(W−1)…2^(W−1)−1 en het bereik zonder teken van 0…2^W−1. De UINT-families hebben geen minimummacro's. Als SIG_ATOMIC_MIN, WCHAR_MIN of WINT_MIN echter voor een type zonder teken is gedefinieerd, heeft die macro de waarde 0.
Voor elke N = 8, 16, 32, 64 omvatten de syntaxpatronen alle genoemde symbolen. INTN_MIN, INTN_MAX, INTN_WIDTH, UINTN_MAX en UINTN_WIDTH beschrijven precies N bits zonder opvulling; deze typen en macro's zijn optioneel. De families INT_LEASTN_*/UINT_LEASTN_* beschrijven de kleinste typen met ten minste N bits; INT_FASTN_*/UINT_FASTN_* beschrijven doorgaans de snelste typen met ten minste N bits, maar niet noodzakelijk de snelste voor elke taak. Beide families zijn vereist voor deze waarden van N en kunnen breder zijn.
INTPTR_MIN, INTPTR_MAX, INTPTR_WIDTH en UINTPTR_MAX, UINTPTR_WIDTH beschrijven de optionele typen intptr_t/uintptr_t, waarmee een void * naar een geheel getal en terug kan worden geconverteerd met behoud van gelijkheid. INTMAX_MIN, INTMAX_MAX, INTMAX_WIDTH, UINTMAX_MAX en UINTMAX_WIDTH beschrijven de vereiste typen intmax_t/uintmax_t; de garantie van het grootste bereik kent uitzonderingen voor bitprecieze typen en bepaalde bredere uitgebreide typen.
PTRDIFF_MIN, PTRDIFF_MAX, PTRDIFF_WIDTH beschrijven ptrdiff_t (verschillen tussen pointers); SIZE_MAX, SIZE_WIDTH beschrijven size_t (groottes). De drietallen SIG_ATOMIC_MIN/SIG_ATOMIC_MAX/SIG_ATOMIC_WIDTH, WCHAR_MIN/WCHAR_MAX/WCHAR_WIDTH en WINT_MIN/WINT_MAX/WINT_WIDTH beschrijven respectievelijk sig_atomic_t, wchar_t en wint_t. Ga niet uit van hun teken. <stdint.h> hoeft deze typen uit andere headers niet te declareren; in een freestanding omgeving kunnen sommige ontbreken.
Controleer optionele macro's met #ifdef. Het voorbeeld controleert vóór de vermenigvuldiging count <= SIZE_MAX / size en beschermt zo ook tegen delen door nul. Een positieve uitkomst betekent alleen dat het product representeerbaar is, niet dat geheugentoewijzing zal slagen.
Referentie-identificatoren die in dit item worden behandeld: 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.
Voorbeelden
#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;
}
Resultaat
small: 1 overflow: 0
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.