Gleitkomma-Umgebung (seit C++11)

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Numerik-Bibliothek

Allgemeine mathematische Funktionen
Mathematische Spezialfunktionen (C++17)
Mathematische Konstanten (C++20)
Grundlegende lineare Algebra-Algorithmen (C++26)
Datenparallele Typen (SIMD) (C++26)
Gleitkomma-Umgebung (C++11)
Komplexe Zahlen
Numerische Arrays (valarray)
Pseudozufallszahlengenerierung
Bit-Manipulation (C++20)
Faktoroperationen
gcd (C++17)	lcm (C++17)
Interpolationen
midpoint (C++20)	lerp (C++20)
Sättigungsarithmetik
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
Generische numerische Operationen
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

Gleitkomma-Umgebung

Funktionen

feclearexcept (C++11)

fetestexcept (C++11)

feraiseexcept (C++11)

fegetexceptflagfesetexceptflag (C++11)(C++11)

fegetroundfesetround (C++11)(C++11)

fegetenvfesetenv (C++11)(C++11)

feholdexcept (C++11)

feupdateenv (C++11)

Makrokonstanten

FE_ALL_EXCEPTFE_DIVBYZEROFE_INEXACTFE_INVALIDFE_OVERFLOWFE_UNDERFLOW (C++11)(C++11)(C++11)(C++11)(C++11)(C++11)

FE_DOWNWARDFE_TONEARESTFE_TOWARDZEROFE_UPWARD (C++11)(C++11)(C++11)(C++11)

FE_DFL_ENV (C++11)

 

Die Gleitkomma-Umgebung ist die Menge der von der Implementierung unterstützten Gleitkomma-Statusflags und Steuerungsmodi. Sie ist threads-lokal. Jeder Thread erbt den Anfangszustand seiner Gleitkomma-Umgebung vom Eltern-Thread. Gleitkommaoperationen ändern die Gleitkomma-Statusflags, um abnormale Ergebnisse oder Hilfsinformationen anzuzeigen. Der Zustand der Gleitkomma-Steuerungsmodi beeinflusst die Ergebnisse einiger Gleitkommaoperationen.

Der Zugriff auf und die Änderung der Gleitkomma-Umgebung ist nur dann sinnvoll, wenn #pragma STDC FENV_ACCESS unterstützt wird und auf ON gesetzt ist. Andernfalls kann die Implementierung frei davon ausgehen, dass Gleitkomma-Steuerungsmodi immer die Standardmodi sind und dass Gleitkomma-Statusflags nie getestet oder geändert werden. In der Praxis unterstützen nur wenige aktuelle Compiler, wie HP aCC, Oracle Studio oder IBM XL, das #pragma explizit, aber die meisten Compiler erlauben dennoch einen sinnvollen Zugriff auf die Gleitkomma-Umgebung.

Typen

Definiert in Header <cfenv>
fenv_t (C++11)	der Typ, der die gesamte Gleitkomma-Umgebung repräsentiert (typedef)
fexcept_t (C++11)	der Typ, der alle Gleitkomma-Statusflags kollektiv repräsentiert (typedef)

Funktionen

feclearexcept (C++11)	löscht die angegebenen Gleitkomma-Statusflags (function)
fetestexcept (C++11)	ermittelt, welche der angegebenen Gleitkomma-Statusflags gesetzt sind (function)
feraiseexcept (C++11)	löst die angegebenen Gleitkomma-Ausnahmen aus (function)
fegetexceptflagfesetexceptflag (C++11)(C++11)	kopiert den Zustand der angegebenen Gleitkomma-Statusflags aus oder in die Gleitkomma-Umgebung (function)
fegetroundfesetround (C++11)(C++11)	holt oder setzt die Rundungsrichtung (function)
fegetenvfesetenv (C++11)	speichert oder stellt die aktuelle Gleitkomma-Umgebung wieder her (function)
feholdexcept (C++11)	speichert die Umgebung, löscht alle Statusflags und ignoriert alle zukünftigen Fehler (function)
feupdateenv (C++11)	stellt die Gleitkomma-Umgebung wieder her und löst die zuvor ausgelösten Ausnahmen aus (function)

Makros

FE_ALL_EXCEPTFE_DIVBYZEROFE_INEXACTFE_INVALIDFE_OVERFLOWFE_UNDERFLOW (C++11)	Gleitkomma-Ausnahmen (macro constant)
FE_DOWNWARDFE_TONEARESTFE_TOWARDZEROFE_UPWARD (C++11)	Gleitkomma-Rundungsrichtung (macro constant)
FE_DFL_ENV (C++11)	Standard-Gleitkomma-Umgebung (macro constant)

Anmerkungen

Die Gleitkomma-Ausnahmen stehen nicht im Zusammenhang mit C++-Ausnahmen. Wenn eine Gleitkommaoperation eine Gleitkomma-Ausnahme auslöst, ändert sich der Zustand der Gleitkomma-Umgebung, was mit std::fetestexcept getestet werden kann, aber die Ausführung eines C++-Programms wird bei den meisten Implementierungen ungehindert fortgesetzt.

Es gibt Compiler-Erweiterungen, die verwendet werden können, um automatisch C++-Ausnahmen zu erzeugen, sobald eine Gleitkomma-Ausnahme ausgelöst wird

• Die GNU libc-Funktion feenableexcept() aktiviert das Abfangen von Gleitkomma-Ausnahmen, was das Signal SIGFPE generiert. Wenn die Compiler-Option -fnon-call-exceptions verwendet wurde, kann der Handler für dieses Signal eine benutzerdefinierte C++-Ausnahme auslösen.
• Die MSVC-Funktion _control87() aktiviert das Abfangen von Gleitkomma-Ausnahmen, was eine Hardware-Ausnahme generiert, die mit _set_se_translator in C++-Ausnahmen umgewandelt werden kann.

Siehe auch

C-Dokumentation für Gleitkomma-Umgebung