CKTIS / C
nearbyint — Rundung gemäß dem aktuellen Modus
nearbyint gibt einen ganzzahligen Wert vom Typ double gemäß der aktuellen Rundungsrichtung zurück, ohne den Ungenauigkeitsfehler auszulösen.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <math.h>
double nearbyint(double x);nearbyint(x) aus <math.h> gibt einen ganzzahligen Wert zurück, der als double und nicht als Ganzzahltyp dargestellt wird. Die Funktion verwendet die aktuelle Rundungsrichtung.
Im Gegensatz zu rint löst sie den Ungenauigkeitsfehler (FE_INEXACT) nicht aus; das bedeutet nicht, dass ein bereits gesetztes Flag gelöscht wird. round rundet Halbwerte dagegen unabhängig vom aktuellen Modus von null weg.
Das Beispiel wählt FE_DOWNWARD, sodass -2.5 den Wert -3.0 ergibt, und stellt anschließend den vorherigen Modus wieder her. Es setzt voraus, dass Compiler und Bibliothek die Gleitkommaumgebung unterstützen; ein C23-Flag allein weist diese Unterstützung nicht nach.
Beispiele
#include <fenv.h>
#include <math.h>
#include <stdio.h>
#pragma STDC FENV_ACCESS ON
int main(void)
{
#ifdef FE_DOWNWARD
int saved = fegetround();
if (saved < 0 || fesetround(FE_DOWNWARD) != 0)
return 1;
volatile double x = -2.5;
double result = nearbyint(x);
if (fesetround(saved) != 0)
return 1;
printf("%.1f\n", result);
return 0;
#else
return 1;
#endif
}Ergebnis
-3.0
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.