CKTIS / C
<float.h> — характеристики на типовете с плаваща запетая
Заглавният файл <float.h> описва точността, диапазона и свойствата на float, double и long double. Използвайте макросите му, вместо да приемате конкретен хардуерен формат; изборът на флаг за компилатор C23 сам по себе си не доказва поддръжка от библиотеката или производствената среда.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <float.h>Включете #include <float.h>. По-долу T означава всеки от префиксите FLT, DBL, LDBL, съответно за float, double, long double; например T_MIN обхваща FLT_MIN, DBL_MIN, LDBL_MIN. Стойностите зависят от реализацията, а не от предполагаем хардуерен формат.
FLT_RADIX е основата b. T_MANT_DIG брои значещите цифри в основа b; T_DIG описва запазването на цифрите при преобразуване десетично число → тип → десетично число, докато T_DECIMAL_DIG описва тип → десетично число → тип, с подходящо закръгляване. Остаряващият DECIMAL_DIG обхваща най-широките поддържани типове и кодирания IEC 60559. T_MIN_EXP е най-малкото e, за което b^(e-1) е нормализирано; T_MAX_EXP е най-голямото e, за което е крайно и представимо. T_MIN_10_EXP и T_MAX_10_EXP задават съответните граници за 10^e: нормализирания диапазон отдолу и крайния диапазон отгоре.
T_MIN е най-малкото положително нормализирано число, а не най-отрицателното; T_TRUE_MIN е най-малкото положително представимо число. T_MAX е най-голямото крайно число, а T_NORM_MAX — най-голямото нормализирано. T_EPSILON е разликата между 1 и следващото по-голямо нормализирано число, а не универсален допуск за сравнение. Остаряващият T_HAS_SUBNORM: -1 неопределено, 0 няма, 1 поддържат се субнормални числа. T_IS_IEC_60559: при 0 точността и диапазонът на експонентите не съответстват на нито един формат IEC 60559; при 1 съответстват на формат IEC 60559, но типът не използва кодиране по IEC 60559; при 2 съответстват на формат IEC 60559 и типът използва и кодиране по IEC 60559. Сам по себе си този макрос не гарантира съответствие с приложение F. Макросите FLT_SNAN, DBL_SNAN и LDBL_SNAN се разгъват до изрази съответно от тип float, double и long double, като стойността на всеки израз е сигнализиращ NaN. Всеки макрос е дефиниран само ако съответният тип поддържа сигнализиращи NaN; проверявайте това с #ifdef.
FLT_ROUNDS описва закръгляването при събиране: -1 неопределено, 0 към нула, 1 към най-близката стойност, 2 към плюс безкрайност, 3 към минус безкрайност, 4 към най-близкото, при равенство отдалеч от нулата; другите стойности зависят от реализацията. При стойност 1 закръгляването към четната стойност при еднакво разстояние е гарантирано от обвързването с IEC 60559 съгласно приложение F, а не от самия макрос FLT_ROUNDS. Стойността може да се променя по време на изпълнение. FLT_EVAL_METHOD: -1 неопределено, 0 форматът на типа, 1 изчисленията на float и double в double, 2 всички в long double; при 1 long double остава непроменен. Другите отрицателни стойности зависят от реализацията. Примерът проверява зависимости, а не конкретни формати.
Референтни идентификатори, обхванати в тази статия: FLT_MANT_DIG, FLT_DECIMAL_DIG, FLT_DIG, FLT_MIN_EXP, FLT_MIN_10_EXP, FLT_MAX_EXP, FLT_MAX_10_EXP, FLT_MAX, FLT_EPSILON, FLT_TRUE_MIN, FLT_HAS_SUBNORM, FLT_IS_IEC_60559, FLT_NORM_MAX, FLT_SNAN, DBL_MANT_DIG, DBL_DECIMAL_DIG, DBL_DIG, DBL_MIN_EXP, DBL_MIN_10_EXP, DBL_MAX_EXP, DBL_MAX_10_EXP, DBL_MAX, DBL_EPSILON, DBL_TRUE_MIN, DBL_HAS_SUBNORM, DBL_IS_IEC_60559, DBL_NORM_MAX, DBL_SNAN, LDBL_MANT_DIG, LDBL_DECIMAL_DIG, LDBL_DIG, LDBL_MIN_EXP, LDBL_MIN_10_EXP, LDBL_MAX_EXP, LDBL_MAX_10_EXP, LDBL_MAX, LDBL_EPSILON, LDBL_TRUE_MIN, LDBL_HAS_SUBNORM, LDBL_IS_IEC_60559, LDBL_NORM_MAX, LDBL_SNAN.
Примери
#include <float.h>
#include <stdio.h>
int main(void)
{
printf("radix >= 2: %d\n", FLT_RADIX >= 2);
printf("positive minimum: %d\n", DBL_MIN > 0.0);
printf("true minimum <= minimum: %d\n", DBL_TRUE_MIN <= DBL_MIN);
printf("maximum >= minimum: %d\n", LDBL_MAX >= LDBL_MIN);
return 0;
}
Резултат
radix >= 2: 1 positive minimum: 1 true minimum <= minimum: 1 maximum >= minimum: 1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.