CKTIS / C
rint — Rundung gemäß dem aktuellen Modus
rint rundet einen endlichen double-Wert gemäß der aktuellen Rundungsrichtung auf einen ganzzahligen Wert und behält dabei den Typ double bei.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <math.h>
double rint(double x);Für ein endliches Argument gibt rint(x) aus <math.h> einen ganzzahligen Wert vom Typ double zurück, nicht int. Das Ergebnis hängt von der aktuellen Rundungsrichtung ab; bei FE_DOWNWARD wird 2.75 zu 2.0. In Implementierungen, die Anhang F entsprechen, gibt rint einen unendlichen Wert unverändert und für ein stilles NaN ein NaN zurück.
Im Gegensatz zu nearbyint kann rint die Ungenauigkeitsausnahme auslösen; Implementierungen, die Anhang F entsprechen, lösen sie aus, wenn sich das Ergebnis vom endlichen Argument unterscheidet. round hingegen ignoriert die aktuelle Richtung und rundet genau in der Mitte liegende Werte von null weg.
Das Beispiel stellt die Richtung ausdrücklich mit fesetround ein und setzt Unterstützung für FENV_ACCESS voraus. Leite die Unterstützung der Gleitkommaumgebung nicht allein aus einem C23-Compiler-Flag ab.
Beispiele
#include <fenv.h>
#include <math.h>
#include <stdio.h>
#pragma STDC FENV_ACCESS ON
int main(void)
{
#ifdef FE_DOWNWARD
if (fesetround(FE_DOWNWARD) != 0) {
return 1;
}
volatile double x = 2.75;
printf("%.0f\n", rint(x));
return 0;
#else
return 1;
#endif
}
Ergebnis
2
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.