Partager via


nearbyint, , nearbyintfnearbyintl

Arrondit la valeur à virgule flottante spécifiée en un entier et retourne cette valeur dans un format à virgule flottante.

Syntaxe

double nearbyint( double x );
float nearbyintf( float x );
long double nearbyintl( long double x );
#define nearbyint( X ) // Requires C11 or higher

float nearbyint( float x ); //C++ only
long double nearbyint( long double x ); //C++ only

Paramètres

x
Valeur à arrondir.

Valeur retournée

En cas de réussite, retourne x, arrondi à l’entier le plus proche, à l’aide du format d’arrondi actuel comme indiqué par fegetround. Sinon, la fonction peut retourner l’une des valeurs suivantes :

Problème Retour
x = ±INFINITY ±INFINITY, non modifié
x = ±0 ±0, non modifié
x = NaN NaN

Les erreurs ne sont pas signalées par le biais _matherrde ; plus précisément, cette fonction ne signale FE_INEXACT aucune exception.

Notes

La principale différence entre cette fonction et rint est que cette fonction ne déclenche pas l’exception à virgule flottante inexacte.

Étant donné que les valeurs à virgule flottante maximales sont des entiers exacts, cette fonction ne provoque jamais de dépassement par elle-même. Cependant, la sortie peut dépasser la valeur de retour, selon la version de la fonction que vous utilisez.

C++ autorisant la surcharge, vous pouvez appeler des surcharges de nearbyint qui acceptent et retournent des paramètres float ou long double. Dans un programme C, sauf si vous utilisez la <macro tgmath.h> pour appeler cette fonction, nearbyint prend toujours deux valeurs doubles et retourne une valeur double.

Si vous utilisez la macro <tgmath.h>nearbyint(), le type de l’argument détermine la version de la fonction sélectionnée. Pour plus d’informations, consultez les mathématiques génériques de type.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Fonction En-tête C En-tête C++
nearbyint, , nearbyintfnearbyintl <math.h> <cmath> ou <math.h>
Macro nearbyint <tgmath.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

Référence de fonction alphabétique
Prise en charge des fonctions mathématiques et à virgule flottante