WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

<fenv.h> — Gleitkommaumgebung

Der Header <fenv.h> stellt Gleitkomma-Ausnahmeflags und Steuermodi bereit. Damit lassen sich Ausnahmezustände untersuchen, Rundungsmodi ändern sowie die Umgebung eines Threads speichern und wiederherstellen.

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

Syntax

#include <fenv.h>
#pragma STDC FENV_ACCESS ON

<fenv.h> verwaltet Statusflags und Steuermodi. fenv_t steht für die gesamte dynamische Umgebung, fexcept_t für den Ausnahmestatus und femode_t nur für die Steuermodi. Die dynamische Umgebung ist an den Thread gebunden.

FE_DIVBYZERO steht für Division durch null, FE_INVALID für eine ungültige Operation, FE_OVERFLOW für Überlauf, FE_UNDERFLOW für Unterlauf und FE_INEXACT für ein ungenaues Ergebnis. Gewöhnliche Rechenoperationen löschen keine bereits gesetzten Ausnahmeflags. Beim Wiederherstellen einer gespeicherten Umgebung mit fesetenv können jedoch Flags gelöscht werden, die im gespeicherten Zustand nicht gesetzt waren, ohne dass feclearexcept separat aufgerufen werden muss. FE_ALL_EXCEPT verbindet alle unterstützten Ausnahmen mit |; gibt es keine, ist der Wert 0. Verwenden Sie feclearexcept und fetestexcept.

FE_DOWNWARD rundet in Richtung −∞, FE_UPWARD in Richtung +∞, FE_TOWARDZERO in Richtung null und FE_TONEAREST auf den nächstgelegenen Wert. FE_TONEARESTFROMZERO rundet ebenfalls auf den nächstgelegenen Wert, wählt bei gleichem Abstand aber den Wert, der weiter von null entfernt ist. Für FE_TONEAREST garantiert die Anbindung an IEC 60559 nach Anhang F bei gleichem Abstand die Rundung zum geraden Wert. Das bloße Vorhandensein des Makros garantiert diese Regel nicht. Makros für einzelne Ausnahmen und Rundungsrichtungen gibt es nur bei entsprechender Unterstützung; prüfen Sie dies mit #ifdef. fegetround liest die dynamische Richtung aus, fesetround setzt sie.

FE_DFL_ENV bezeichnet die Standardumgebung für fesetenv; FE_DFL_MODE bezeichnet Standardmodi für fesetmode, ohne Flags wiederherzustellen. FE_DYNAMIC ist ein Token für #pragma STDC FENV_ROUND FE_DYNAMIC, das dynamische Rundung auswählt, und kein Argument für fesetround.

Verwenden Sie #pragma STDC FENV_ACCESS ON, wenn Sie Flags prüfen oder nicht standardmäßige dynamische Modi verwenden. Prüfen Sie die Ergebnisse der Operationen und stellen Sie den gespeicherten Zustand wieder her. Die Auswahl von C23 im Compiler eines Repositorys allein belegt keine Unterstützung in der Produktionslaufzeit.

Beispiele

#include <fenv.h>
#include <stdio.h>
#include <stdlib.h>

#pragma STDC FENV_ACCESS ON

int main(void)
{
    fenv_t saved;
    int cleared;

    if (fegetenv(&saved) != 0)
        return EXIT_FAILURE;

    if (feclearexcept(FE_ALL_EXCEPT) != 0) {
        (void)fesetenv(&saved);
        return EXIT_FAILURE;
    }

    cleared = fetestexcept(FE_ALL_EXCEPT) == 0;
    if (fesetenv(&saved) != 0)
        return EXIT_FAILURE;

    puts(cleared ? "flags clear" : "unexpected flags");
    return cleared ? EXIT_SUCCESS : EXIT_FAILURE;
}

Ergebnis

flags clear

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