База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници