FE_DOWNWARD, FE_TONEAREST, FE_TOWARDZERO, FE_UPWARD
| Definiert in der Headerdatei <fenv.h> |
||
| #define FE_DOWNWARD /*implementierungsabhängig*/ |
(seit C99) | |
| #define FE_TONEAREST /*implementierungsabhängig*/ |
(seit C99) | |
| #define FE_TOWARDZERO /*implementierungsabhängig*/ |
(seit C99) | |
| #define FE_UPWARD /*implementierungsabhängig*/ |
(seit C99) | |
Jede dieser Makrokonstanten wird zu einem nicht-negativen ganzzahligen konstanten Ausdruck erweitert, der mit fesetround und fegetround verwendet werden kann, um einen der unterstützten Gleitkomma-Rundungsmodi anzugeben. Die Implementierung kann zusätzliche Konstanten für Rundungsmodi in <fenv.h> definieren, die alle mit FE_ gefolgt von mindestens einem Großbuchstaben beginnen sollten. Jedes Makro ist nur definiert, wenn es unterstützt wird.
| Konstante | Erklärung |
FE_DOWNWARD
|
Rundung in Richtung negativer Unendlichkeit |
FE_TONEAREST
|
Rundung zum nächstgelegenen darstellbaren Wert |
FE_TOWARDZERO
|
Rundung in Richtung Null |
FE_UPWARD
|
Rundung in Richtung positiver Unendlichkeit |
Zusätzliche Rundungsmodi können von einer Implementierung unterstützt werden.
Der aktuelle Rundungsmodus beeinflusst die folgenden
- Ergebnisse von Gleitkomma-Arithmetikoperatoren außerhalb von konstanten Ausdrücken
double x = 1; x / 10; // 0.09999999999999999167332731531132594682276248931884765625 or // 0.1000000000000000055511151231257827021181583404541015625
- Ergebnisse von Standardbibliotheks-Mathematikfunktionen
sqrt(2); // 1.41421356237309492343001693370752036571502685546875 or // 1.4142135623730951454746218587388284504413604736328125
- implizite Konvertierungen und Casts von Gleitkomma zu Gleitkomma
double d = 1 + DBL_EPSILON; float f = d; // 1.00000000000000000000000 or // 1.00000011920928955078125
lrint(2.1); // 2 or 3
Der aktuelle Rundungsmodus beeinflusst NICHT die folgenden
- implizite Konvertierungen und Casts von Gleitkomma zu Ganzzahl (immer in Richtung Null)
- Ergebnisse von Gleitkomma-Arithmetikoperatoren in konstanten Ausdrücken, die zur Kompilierzeit ausgeführt werden (immer zum nächstgelegenen)
- die Bibliotheksfunktionen round, lround, llround, ceil, floor, trunc
Wie bei jeder Gleitkomma-Umgebungsfunktionalität ist die Rundung nur garantiert, wenn #pragma STDC FENV_ACCESS ON gesetzt ist.
Compiler, die das Pragma nicht unterstützen, bieten möglicherweise eigene Möglichkeiten zur Unterstützung des aktuellen Rundungsmodus. Zum Beispiel haben Clang und GCC die Option -frounding-math, die dazu dient, Optimierungen zu deaktivieren, die die Bedeutung von rundungssensitiven Code verändern würden.
[bearbeiten] Beispiel
#include <fenv.h> #include <math.h> #include <stdio.h> #include <stdlib.h> // #pragma STDC FENV_ACCESS ON int main() { fesetround(FE_DOWNWARD); puts("rounding down: "); printf(" pi = %.22f\n", acosf(-1)); printf("strtof(\"1.1\") = %.22f\n", strtof("1.1", NULL)); printf(" rint(2.1) = %.22f\n\n", rintf(2.1)); fesetround(FE_UPWARD); puts("rounding up: "); printf(" pi = %.22f\n", acosf(-1)); printf("strtof(\"1.1\") = %.22f\n", strtof("1.1", NULL)); printf(" rint(2.1) = %.22f\n", rintf(2.1)); }
Ausgabe
rounding down:
pi = 3.1415925025939941406250
strtof("1.1") = 1.0999999046325683593750
rint(2.1) = 2.0000000000000000000000
rounding up:
pi = 3.1415927410125732421875
strtof("1.1") = 1.1000000238418579101563
rint(2.1) = 3.0000000000000000000000[bearbeiten] Referenzen
- C23-Standard (ISO/IEC 9899:2024)
- 7.6/8 Gleitkomma-Umgebung <fenv.h> (S. TBD)
- C17-Standard (ISO/IEC 9899:2018)
- 7.6/8 Gleitkomma-Umgebung <fenv.h> (S. 151)
- C11-Standard (ISO/IEC 9899:2011)
- 7.6/8 Gleitkomma-Umgebung <fenv.h> (S. 207)
- C99-Standard (ISO/IEC 9899:1999)
- 7.6/7 Gleitkomma-Umgebung <fenv.h> (S. 188)
[bearbeiten] Siehe auch
| (C99)(C99) |
holt oder setzt die Rundungsrichtung (function) |
| C++ Dokumentation für Gleitkomma-Rundungsmakros
| |
