CKTIS / C
<float.h> — eigenschappen van floating-pointtypen
De header <float.h> beschrijft de precisie, het bereik en de eigenschappen van float, double en long double. Gebruik de macro’s in plaats van een hardwareformaat aan te nemen; alleen een C23-compileroptie kiezen bevestigt niet dat de bibliotheek of productieomgeving ondersteuning biedt.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <float.h>Neem #include <float.h> op. Hieronder staat T voor elk van de voorvoegsels FLT, DBL, LDBL, respectievelijk voor float, double, long double; T_MIN omvat bijvoorbeeld FLT_MIN, DBL_MIN, LDBL_MIN. De waarden zijn afhankelijk van de implementatie, niet van een verondersteld hardwareformaat.
FLT_RADIX is het grondtal b. T_MANT_DIG telt significante cijfers in grondtal b; T_DIG beschrijft het behoud van cijfers bij de omzetting decimaal → type → decimaal, terwijl T_DECIMAL_DIG type → decimaal → type beschrijft, met passende afronding. Het verouderende DECIMAL_DIG omvat de breedste ondersteunde typen en IEC 60559-coderingen. T_MIN_EXP is de kleinste e waarvoor b^(e-1) genormaliseerd is; T_MAX_EXP de grootste e waarvoor het eindig en representeerbaar is. T_MIN_10_EXP en T_MAX_10_EXP geven overeenkomstige grenzen voor 10^e: onderaan het genormaliseerde bereik en bovenaan het eindige bereik.
T_MIN is het kleinste positieve genormaliseerde getal, niet het meest negatieve; T_TRUE_MIN is het kleinste positieve representeerbare getal. T_MAX is het grootste eindige getal, terwijl T_NORM_MAX het grootste genormaliseerde getal is. T_EPSILON is het verschil tussen 1 en het eerstvolgende grotere genormaliseerde getal, geen universele vergelijkingstolerantie. Verouderend T_HAS_SUBNORM: -1 onbepaald, 0 afwezig, 1 subnormale getallen ondersteund. T_IS_IEC_60559: bij 0 komen de precisie en het exponentbereik met geen enkel IEC 60559-formaat overeen; bij 1 komen ze overeen met een IEC 60559-formaat, maar gebruikt het type geen IEC 60559-codering; bij 2 komen ze overeen met een IEC 60559-formaat en gebruikt het type ook een IEC 60559-codering. Deze macro alleen garandeert niet dat aan bijlage F wordt voldaan. De macro’s FLT_SNAN, DBL_SNAN en LDBL_SNAN expanderen tot expressies van respectievelijk het type float, double en long double, elk met een signalerende NaN als waarde. Elke macro is alleen gedefinieerd als het bijbehorende type signalerende NaN’s ondersteunt; controleer dit met #ifdef.
FLT_ROUNDS beschrijft afronding bij optellen: -1 onbepaald, 0 naar nul, 1 naar de dichtstbijzijnde waarde, 2 naar plus oneindig, 3 naar min oneindig, 4 naar het dichtstbijzijnde met gelijke afstanden van nul af; andere waarden zijn implementatieafhankelijk. Bij 1 garandeert de koppeling met IEC 60559 volgens bijlage F dat bij gelijke afstand naar de even waarde wordt afgerond; FLT_ROUNDS alleen biedt die garantie niet. Het kan tijdens runtime veranderen. FLT_EVAL_METHOD: -1 onbepaald, 0 typeformaat, 1 berekeningen van float en double in double, 2 alle berekeningen in long double; bij 1 blijft long double onveranderd. Andere negatieve waarden zijn implementatieafhankelijk. Het voorbeeld controleert relaties in plaats van specifieke formaten.
Referentie-identificatoren die in dit item worden behandeld: 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.
Voorbeelden
#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;
}
Resultaat
radix >= 2: 1 positive minimum: 1 true minimum <= minimum: 1 maximum >= minimum: 1
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.