CKTIS / C
<float.h> — charakterystyka typów zmiennoprzecinkowych
Nagłówek <float.h> opisuje precyzję, zakres i właściwości typów float, double oraz long double. Korzystaj z makr zamiast zakładać konkretny format sprzętowy; sam wybór flagi C23 nie potwierdza obsługi biblioteki ani środowiska produkcyjnego.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <float.h>Dołącz #include <float.h>. Poniżej T oznacza każdy z prefiksów FLT, DBL, LDBL, odpowiednio dla float, double, long double; np. T_MIN obejmuje FLT_MIN, DBL_MIN, LDBL_MIN. Wartości zależą od implementacji, nie od oczekiwanego formatu sprzętowego.
FLT_RADIX to podstawa b. T_MANT_DIG liczy cyfry znaczące w bazie b; T_DIG opisuje zachowanie cyfr przy konwersji dziesiętne → typ → dziesiętne, a T_DECIMAL_DIG przy typ → dziesiętne → typ, z odpowiednim zaokrąglaniem. Przestarzałe DECIMAL_DIG obejmuje najszersze obsługiwane typy i kodowania IEC 60559. T_MIN_EXP to najmniejsze e, dla którego b^(e-1) jest znormalizowane; T_MAX_EXP to największe e, dla którego jest skończone i reprezentowalne. T_MIN_10_EXP i T_MAX_10_EXP wyznaczają analogiczne granice dla 10^e: zakres znormalizowany na dole, skończony na górze.
T_MIN to najmniejsza dodatnia liczba znormalizowana, nie najbardziej ujemna; T_TRUE_MIN to najmniejsza dodatnia liczba reprezentowalna. T_MAX jest największą skończoną, a T_NORM_MAX największą znormalizowaną. T_EPSILON to odstęp od 1 do następnej większej liczby znormalizowanej, nie uniwersalna tolerancja porównań. Przestarzałe T_HAS_SUBNORM: -1 nieokreślone, 0 brak, 1 obsługa liczb subnormalnych. T_IS_IEC_60559: 0 — precyzja i zakres wykładników nie odpowiadają żadnemu formatowi IEC 60559; 1 — odpowiadają formatowi IEC 60559, ale typ nie używa kodowania IEC 60559; 2 — odpowiadają formatowi IEC 60559 i typ używa również kodowania IEC 60559. Samo to makro nie gwarantuje zgodności z aneksem F. Makra FLT_SNAN, DBL_SNAN i LDBL_SNAN rozwijają się do wyrażeń odpowiednio typu float, double i long double, których wartością jest sygnalizujący NaN. Każde z tych makr jest zdefiniowane tylko wtedy, gdy dany typ obsługuje sygnalizujące NaN; sprawdzaj to za pomocą #ifdef.
FLT_ROUNDS opisuje zaokrąglanie dodawania: -1 nieokreślone, 0 ku zeru, 1 do najbliższej wartości, 2 ku dodatniej, 3 ku ujemnej nieskończoności, 4 do najbliższej z remisami od zera; inne wartości zależą od implementacji. Dla 1 zaokrąglanie do parzystej przy remisie gwarantują reguły powiązania z IEC 60559 opisane w aneksie F, a nie samo makro FLT_ROUNDS. Może zmieniać się w czasie wykonania. FLT_EVAL_METHOD: -1 nieokreślone, 0 format typu, 1 obliczenia float i double w double, 2 wszystkie w long double; przy 1 typ long double pozostaje bez zmian. Inne wartości ujemne zależą od implementacji. Przykład sprawdza relacje zamiast konkretnych formatów.
Identyfikatory objęte tym wpisem: 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.
Przykłady
#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;
}
Wynik
radix >= 2: 1 positive minimum: 1 true minimum <= minimum: 1 maximum >= minimum: 1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.