Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

nearbyint — zaokrouhlení podle aktuálního režimu

nearbyint vrací celočíselnou hodnotu typu double podle aktuálního směru zaokrouhlování, aniž by vyvolala výjimku nepřesnosti.

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

Syntaxe

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

nearbyint(x) z <math.h> vrací celočíselnou hodnotu reprezentovanou jako double, nikoli jako celočíselný typ. Používá aktuální směr zaokrouhlování.

Na rozdíl od rint nevyvolává výjimku nepřesnosti (FE_INEXACT); to ale neznamená, že smaže již nastavený příznak. Naproti tomu round zaokrouhluje případy přesně uprostřed směrem od nuly bez ohledu na aktuální režim.

Příklad nastaví FE_DOWNWARD, takže -2.5 dá výsledek -3.0, a poté obnoví předchozí režim. Vyžaduje podporu prostředí s plovoucí desetinnou čárkou v překladači i knihovně; samotný příznak C23 tuto podporu nedokládá.

Příklady

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

Výsledek

-3.0

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje