WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen