RINT(3)

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

SYNOPSIS
#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);

Utilisez -lm à l'édition de liens pour lier avec la bibliothèque mathématique.

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

nearbyint(), nearbyintf(), nearbyintl() : _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE ; ou cc -std=c99
rint(), rintf(), rintl() : _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE ; ou cc -std=c99

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 entière 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 nombres en virgule flottante 32 bits et 64 bits obéissant à la norme IEEE-754, la valeur maximale de l'exposant est 128 (respectivement 1024) et le nombre de bits de la mantisse est 24 (respectivement 53).

VOIR AUSSI
ceil(3), floor(3), lrint(3), round(3), trunc(3)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 7 novembre 1996 et révisée le 17 juillet 2008.

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 rint ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.