CKTIS / C
Граници и ширини на целите числа в <stdint.h>
Макросите от <stdint.h> описват диапазоните и битовите ширини на целочислените типове. Те помагат да се проверява преносимостта и да се отхвърлят прекалено големи изчисления, преди да бъдат извършени. C23 добавя макроси, завършващи на _WIDTH.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#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> предоставя константи, които могат да се използват в #if: _MIN и _MAX задават включителните граници; C23 добавя _WIDTH за битовата ширина, включително знака, но без битовете за запълване. При ширина W диапазонът със знак е −2^(W−1)…2^(W−1)−1, а този без знак е 0…2^W−1. Семействата UINT нямат макроси за минимум. Ако обаче SIG_ATOMIC_MIN, WCHAR_MIN или WINT_MIN е дефиниран за тип без знак, стойността на съответния макрос е 0.
За всяко N = 8, 16, 32, 64 синтактичните шаблони обхващат всички изброени символи. INTN_MIN, INTN_MAX, INTN_WIDTH, UINTN_MAX и UINTN_WIDTH описват точно N бита без запълване; тези типове и макроси са незадължителни. Семействата INT_LEASTN_*/UINT_LEASTN_* описват най-малките типове с поне N бита; INT_FASTN_*/UINT_FASTN_* описват обикновено най-бързите типове с поне N бита, но не непременно най-бързите за всяка задача. И двете семейства са задължителни за тези стойности на N и може да са по-широки.
INTPTR_MIN, INTPTR_MAX, INTPTR_WIDTH и UINTPTR_MAX, UINTPTR_WIDTH описват незадължителните типове intptr_t/uintptr_t, които позволяват преобразуване на void * в цяло число и обратно със запазване на равенството. INTMAX_MIN, INTMAX_MAX, INTMAX_WIDTH, UINTMAX_MAX и UINTMAX_WIDTH описват задължителните типове intmax_t/uintmax_t; гаранцията за най-голям диапазон има изключения при типове с точна битова прецизност и някои по-широки разширени типове.
PTRDIFF_MIN, PTRDIFF_MAX, PTRDIFF_WIDTH описват ptrdiff_t (разлики между указатели); SIZE_MAX, SIZE_WIDTH описват size_t (размери). Тройките SIG_ATOMIC_MIN/SIG_ATOMIC_MAX/SIG_ATOMIC_WIDTH, WCHAR_MIN/WCHAR_MAX/WCHAR_WIDTH и WINT_MIN/WINT_MAX/WINT_WIDTH описват съответно sig_atomic_t, wchar_t и wint_t. Не приемайте предварително, че са със или без знак. <stdint.h> не е задължен да декларира тези типове от други заглавни файлове; в freestanding среда някои може да липсват.
Проверявайте незадължителните макроси с #ifdef. Примерът проверява count <= SIZE_MAX / size преди умножението, като така предпазва и от деление на нула. Положителният резултат означава само, че произведението може да бъде представено, а не че заделянето на памет ще успее.
Референтни идентификатори, обхванати в тази статия: 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.
Примери
#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;
}
Резултат
small: 1 overflow: 0
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.