Nom

rint, rintf, rintl, nearbyint, nearbyintf, nearbyintl - Arrondir à l'entier le plus proche.

Résumé

.nf #include <math.h> double nearbyint(double x ); float nearbyintf(float x ); long double nearbyintl(long double x ); double rint(double x ); float rintf(float x ); long double rintl(long double x ); .fi

Description

Les fonctions nearbyint arrondissent leur argument à l'entier le plus proche, dans un format en virgule flottante, en utilisant la direction d'approximation courante, et sans déclencher l'exception inexact .
 
  La fonction rint fait la même chose, mais peut déclencher l'exception inexact lorsque le résultat diffère de l'argument.

Valeur renvoyée

La valeur arrondie. Si x est entier ou infini, la valeur renvoyée est x lui-même.

Erreurs

Seules les erreurs EDOM et ERANGE peuvent se produire. Si x est NaN, alors la valeur renvoyée est NaN et errno peur contenir EDOM.

Notes

Les Spécifications SUSv2 et POSIX 1003.1-2001 contiennent un passage sur les débordements (qui peuvent remplir errno avec ERANGE ou déclencher une exception). En pratique, aucun débordement ne peut se produire sur les machines actuelles, ce qui rend inutile cette gestion d'erreur. Plus précisément, le débordement ne peut se produire que si la valeur maximale de l'exposant est plus petite que le nombre de de bits de la mantisse. Pour les standards 32 bits et 64 bits IEEE-754 la valeur maximale de l'exposant est 128 (respectivement 1024) et le nombre de bits de la mantisse est 24 (respectivement 53).

Pour utiliser les fonctions de la bibliothèque mathématique, il ne faut pas oublier d'ajouter l'argument -lm sur la ligne de commande de cc(1) ou ld(1), lors de l'édition des liens.

Conformité

La fonction rint () est conforme à BSD 4.3 Les autres fonctions proviennent de C99.

Voir aussi

ceil (3), floor (3), lrint (3), nearbyint (3), round (3), trunc (3)

Traduction

Christophe Blaess, 1996-2003.