NOM

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

BIBLIOTHÈQUE

       Bibliothèque de math (libm, -lm)

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

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

       nearbyint(), nearbyintf(), nearbyintl() :
           _POSIX_C_SOURCE >= 200112L || _ISOC99_SOURCE

       rint() :
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
               || _XOPEN_SOURCE >= 500
               || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
               || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

       rintf(), rintl() :
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
               || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
               || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

       Les  fonctions  nearbyint(),  nearbyintf() et nearbyintl() arrondissent leur paramètre à l'entier le plus
       proche, dans un  format  en  virgule  flottante,  en  utilisant  la  direction  d'approximation  actuelle
       (consultez  fesetround(3)),  et  sans  déclencher l'exception inexact. Quand la direction d'approximation
       actuelle est vers le plus proche, ces fonctions arrondissent les cas à mi-chemin vers  l'entier  pair  en
       accord avec la norme IEEE-754.

       Les  fonctions rint(), rintf() et rintl() font la même chose, mais peuvent déclencher l'exception inexact
       (FE_INEXACT, vérifiable par fetestexcept(3)) lorsque le résultat diffère du paramètre.

VALEUR RENVOYÉE

       Ces fonctions renvoient la valeur entière arrondie.

       Si x est un nombre entier, +0, -0, NaN ou une valeur infinie, la valeur x elle-même est renvoyée.

ERREURS

       Aucune erreur n'est survenue'

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ Interface                                                            │ Attribut             │ Valeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ nearbyint(), nearbyintf(), nearbyintl(), rint(), rintf(), rintl()    │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       C11, POSIX.1-2008.

HISTORIQUE

       C99, POSIX.1-2001.

       SUSv2 and POSIX.1-2001 contain text about overflow  (which  might  set  errno  to  ERANGE,  or  raise  an
       FE_OVERFLOW  exception).  In  practice,  the  result  cannot  overflow  on  any  current machine, so this
       error-handling stuff was just nonsense. (More precisely, overflow can happen only when the maximum  value
       of  the exponent is smaller than the number of mantissa bits. For the IEEE-754 standard 32-bit and 64-bit
       floating-point numbers the maximum value of the exponent is 127 (respectively, 1023), and the  number  of
       mantissa bits including the implicit bit is 24 (respectively, 53).) This was removed in POSIX.1-2008.

       Si vous voulez stocker la valeur arrondie dans un type entier, vous devriez probablement utiliser une des
       fonctions décrites dans lrint(3) à la place.

VOIR AUSSI

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

TRADUCTION

       La   traduction   française   de   cette   page   de   manuel   a   été   créée   par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,   Stéphan   Rafin   <stephan.rafin@laposte.net>,   Thierry   Vignaud
       <tvignaud@mandriva.com>,  François  Micaux,  Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,      Thomas      Huriaux      <thomas.huriaux@gmail.com>,     Nicolas     François
       <nicolas.francois@centraliens.net>,    Florentin    Duneau    <fduneau@gmail.com>,     Simon     Paillard
       <simon.paillard@resel.enst-bretagne.fr>,     Denis    Barbier    <barbier@debian.org>,    David    Prévot
       <david@tilapin.org>,  Cédric  Boutillier  <cedric.boutillier@gmail.com>  et  Jean-Pierre  Giraud   <jean-
       pierregiraud@neuf.fr>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel,  veuillez  envoyer  un  message  à
       debian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.9.1                    16 juin 2024                                           rint(3)