Nom

round, roundf, roundl -Arrondir à l'entier le plus proche en s'éloignant de zéro.

Résumé

.nf #include <math.h> double round(double x ); float roundf(float x ); long double roundl(long double x ); .fi

Description

Ces fonctions arrondissent leur argument à l'entier le plus proche en s'éloignant de zéro (sans tenir compte de la direction d'approximation en cours), à la différence de l'arrondi vers l'entier pair le plus proche comme rint().

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é

C99.

Voir aussi

ceil (3), floor (3), lround (3), nearbyint (3), rint (3), trunc (3)

Traduction

Christophe Blaess, 2001-2003.