WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

<float.h> — Eigenschaften der Gleitkommatypen

Der Header <float.h> beschreibt Genauigkeit, Wertebereich und Eigenschaften von float, double und long double. Verwende seine Makros, statt ein bestimmtes Hardwareformat vorauszusetzen; allein die Wahl einer C23-Compileroption belegt weder die Unterstützung durch die Bibliothek noch die Produktionslaufzeit.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <float.h>

Binde #include <float.h> ein. Im Folgenden steht T für jedes der Präfixe FLT, DBL, LDBL, entsprechend float, double, long double; T_MIN umfasst also etwa FLT_MIN, DBL_MIN, LDBL_MIN. Die Werte hängen von der Implementierung ab, nicht von einem angenommenen Hardwareformat.

FLT_RADIX ist die Basis b. T_MANT_DIG zählt die signifikanten Stellen zur Basis b; T_DIG beschreibt die Erhaltung von Stellen bei der Umwandlung dezimal → Typ → dezimal, während T_DECIMAL_DIG die Umwandlung Typ → dezimal → Typ mit geeigneter Rundung beschreibt. Das veraltende DECIMAL_DIG deckt die breitesten unterstützten Typen und IEC-60559-Kodierungen ab. T_MIN_EXP ist das kleinste e, für das b^(e-1) normalisiert ist; T_MAX_EXP das größte e, für das es endlich und darstellbar ist. T_MIN_10_EXP und T_MAX_10_EXP geben entsprechende Grenzen für 10^e an: unten den normalisierten, oben den endlichen Bereich.

T_MIN ist die kleinste positive normalisierte Zahl, nicht die negativste; T_TRUE_MIN ist die kleinste positive darstellbare Zahl. T_MAX ist die größte endliche Zahl, T_NORM_MAX die größte normalisierte. T_EPSILON ist der Abstand von 1 zur nächstgrößeren normalisierten Zahl, keine allgemeingültige Vergleichstoleranz. Das veraltende T_HAS_SUBNORM: -1 unbestimmt, 0 nicht vorhanden, 1 Subnormalzahlen unterstützt. T_IS_IEC_60559: 0 bedeutet, dass Genauigkeit und Exponentenbereich keinem IEC-60559-Format entsprechen; bei 1 entsprechen sie einem IEC-60559-Format, der Typ verwendet aber keine IEC-60559-Kodierung; bei 2 entsprechen sie einem IEC-60559-Format und der Typ verwendet auch eine IEC-60559-Kodierung. Das Makro allein garantiert keine Konformität mit Anhang F. FLT_SNAN, DBL_SNAN und LDBL_SNAN expandieren zu Ausdrücken der Typen float, double bzw. long double, deren Wert jeweils ein signalisierendes NaN ist. Jedes Makro ist nur definiert, wenn der zugehörige Typ signalisierende NaNs unterstützt; prüfe das mit #ifdef.

FLT_ROUNDS beschreibt die Rundung bei Addition: -1 unbestimmt, 0 gegen null, 1 zur nächsten Zahl, 2 gegen positive Unendlichkeit, 3 gegen negative Unendlichkeit, 4 zur nächsten Zahl, Gleichstände von null weg; andere Werte sind implementierungsdefiniert. Bei 1 garantiert die Anbindung an IEC 60559 nach Anhang F, dass bei gleichem Abstand zur geraden Zahl gerundet wird; FLT_ROUNDS allein garantiert das nicht. Der Wert kann sich zur Laufzeit ändern. FLT_EVAL_METHOD: -1 unbestimmt, 0 Format des Typs, 1 Berechnungen von float und double in double, 2 alle in long double; bei 1 bleibt long double unverändert. Andere negative Werte sind implementierungsdefiniert. Das Beispiel prüft Beziehungen statt bestimmter Formate.

In diesem Eintrag behandelte Referenzbezeichner: 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.

Beispiele

#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;
}

Ergebnis

radix >= 2: 1
positive minimum: 1
true minimum <= minimum: 1
maximum >= minimum: 1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen