nearbyint
, nearbyintf
, nearbyintl
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 | Renvoie |
---|---|
x = ±INFINITY |
±INFINITY, non modifié |
x = ±0 |
±0, non modifié |
x = NaN |
NaN |
Les erreurs ne sont pas signalées par le biais _matherr
de ; 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 , nearbyintf , nearbyintl |
<math.h> | <cmath> ou <math.h> |
Macro nearbyint |
<tgmath.h> |
Pour plus d’informations sur la compatibilité, consultez Compatibility.
Voir aussi
Informations de référence sur les fonctions alphabétiques
Prise en charge mathématique et à virgule flottante
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour