CKTIS / C
<float.h> — caratteristiche dei tipi in virgola mobile
L’intestazione <float.h> descrive precisione, intervallo e proprietà di float, double e long double. Usa le macro invece di presumere un formato hardware specifico; la sola scelta di un’opzione del compilatore C23 non attesta il supporto della libreria né dell’ambiente di produzione.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <float.h>Includi #include <float.h>. Di seguito, T indica ciascuno dei prefissi FLT, DBL, LDBL, rispettivamente per float, double, long double; per esempio, T_MIN comprende FLT_MIN, DBL_MIN, LDBL_MIN. I valori dipendono dall’implementazione, non da un formato hardware presunto.
FLT_RADIX è la base b. T_MANT_DIG conta le cifre significative in base b; T_DIG descrive la conservazione delle cifre nella conversione decimale → tipo → decimale, mentre T_DECIMAL_DIG descrive la conversione tipo → decimale → tipo, con arrotondamento appropriato. DECIMAL_DIG, obsoleto, comprende i tipi supportati più ampi e le codifiche IEC 60559. T_MIN_EXP è il più piccolo e per cui b^(e-1) è normalizzato; T_MAX_EXP è il più grande e per cui è finito e rappresentabile. T_MIN_10_EXP e T_MAX_10_EXP indicano i limiti corrispondenti per 10^e: l’intervallo normalizzato al limite inferiore e quello finito al limite superiore.
T_MIN è il più piccolo numero positivo normalizzato, non il più negativo; T_TRUE_MIN è il più piccolo numero positivo rappresentabile. T_MAX è il più grande numero finito, mentre T_NORM_MAX è il più grande normalizzato. T_EPSILON è la distanza tra 1 e il successivo numero normalizzato maggiore, non una tolleranza universale per i confronti. T_HAS_SUBNORM, obsoleto: -1 indeterminabile, 0 assenti, 1 supportati i subnormali. T_IS_IEC_60559: 0 indica che la precisione e l’intervallo degli esponenti non corrispondono ad alcun formato IEC 60559; 1 indica che corrispondono a un formato IEC 60559, ma il tipo non usa una codifica IEC 60559; 2 indica che corrispondono a un formato IEC 60559 e che il tipo usa anche una codifica IEC 60559. Questa macro da sola non garantisce la conformità all’allegato F. FLT_SNAN, DBL_SNAN e LDBL_SNAN si espandono in espressioni di tipo float, double e long double, rispettivamente, il cui valore è un NaN segnalante. Ciascuna macro è definita solo se il tipo corrispondente supporta i NaN segnalanti; verifica che sia definita con #ifdef.
FLT_ROUNDS descrive l’arrotondamento delle addizioni: -1 indeterminabile, 0 verso zero, 1 al più vicino, 2 verso più infinito, 3 verso meno infinito, 4 al più vicino con i casi a metà lontano da zero; altri valori dipendono dall’implementazione. Per 1, l’arrotondamento al pari nei casi a metà è garantito dal collegamento a IEC 60559 definito nell’allegato F, non dalla sola macro FLT_ROUNDS. Può cambiare durante l’esecuzione. FLT_EVAL_METHOD: -1 indeterminabile, 0 formato del tipo, 1 calcoli di float e double in double, 2 tutti in long double; con 1, long double resta invariato. Altri valori negativi dipendono dall’implementazione. L’esempio verifica relazioni anziché formati specifici.
Identificatori di riferimento trattati in questa voce: 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.
Esempi
#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;
}
Risultato
radix >= 2: 1 positive minimum: 1 true minimum <= minimum: 1 maximum >= minimum: 1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.