ROUND(3)

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

SYNOPSIS
#include <math.h>

double round(double x);
float roundf(float x);
long double roundl(long double x);

Exigences de macros de test de fonctionalités pour la glibc (voir feature_test_macros(7)) :

round(), roundf(), roundl() : _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE ; ou cc -std=c99

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(3).

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 peut contenir EDOM.

CONFORMITÉ
C99.

NOTES
Les spécifications SUSv2 et POSIX.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 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.

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

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 7 juin 2001 et révisée le 19 décembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 round ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.