Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

nearbyint — arrondi selon le mode courant

nearbyint renvoie une valeur entière de type double en suivant la direction d’arrondi courante, sans déclencher l’exception d’inexactitude.

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

Syntaxe

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

nearbyint(x) de <math.h> renvoie une valeur entière représentée par un double, et non par un type entier. Elle utilise la direction d’arrondi courante.

Contrairement à rint, elle ne déclenche pas l’exception d’inexactitude (FE_INEXACT) ; cela ne signifie pas qu’elle efface un indicateur déjà présent. En revanche, round arrondit les cas à mi-chemin en s’éloignant de zéro, quel que soit le mode courant.

L’exemple sélectionne FE_DOWNWARD : -2.5 donne donc -3.0, puis le mode précédent est rétabli. Il nécessite la prise en charge de l’environnement à virgule flottante par le compilateur et la bibliothèque ; un indicateur C23 ne suffit pas à établir cette prise en charge.

Exemples

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

Résultat

-3.0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources