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 :

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

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