KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

nearbyint — afronden volgens de huidige modus

nearbyint retourneert een gehele waarde van het type double volgens de huidige afrondingsrichting, zonder de inexacte uitzondering te veroorzaken.

Versie: C23; repository compiler flag, production runtime not attested

Syntax

#include <math.h>
double nearbyint(double x);

nearbyint(x) uit <math.h> retourneert een gehele waarde die wordt weergegeven als double, niet als een geheel-getaltype. De functie gebruikt de huidige afrondingsrichting.

In tegenstelling tot rint veroorzaakt de functie de inexacte uitzondering (FE_INEXACT) niet; dat betekent niet dat een bestaande vlag wordt gewist. round rondt halve gevallen daarentegen van nul af, ongeacht de huidige modus.

Het voorbeeld selecteert FE_DOWNWARD, waardoor -2.5 -3.0 oplevert, en herstelt daarna de vorige modus. Hiervoor is ondersteuning voor de floating-pointomgeving door de compiler en bibliotheek nodig; een C23-vlag alleen toont die ondersteuning niet aan.

Voorbeelden

#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
}

Resultaat

-3.0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen