NOM

       drem,  dremf,  dreml,  remainder,  remainderf,  remainderl  -  Fonction  reste  en virgule
       flottante

SYNOPSIS

       #include <math.h>

       /* Les versions C99 */
       double remainder(double x, double y);
       float remainderf(float x, float y);
       long double remainderl(long double x, long double y);

       /* Synonymes obsolètes */
       double drem(double x, double y);
       float dremf(float x, float y);
       long double dreml(long double x, long double y);

       Effectuez l'édition des liens avec l'option -lm.

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

       remainder() :
           _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500 ||
           _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L
           ou cc -std=c99
       remainderf(), remainderl() :
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L
           ou cc -std=c99
       drem(), dremf(), dreml() :
           _SVID_SOURCE || _BSD_SOURCE

DESCRIPTION

       La fonction remainder() calcule le reste de la division de x par y. La valeur renvoyée est
       x-n*y,  où n est la valeur x / y, arrondie à l'entier le plus proche. Si la valeur absolue
       de x-n*y vaut 0,5, un n pair est choisi.

       Ces fonctions ne sont pas affectées par le mode d'arrondi en cours (voir fenv(3)).

       La fonction drem() fait précisément la même chose.

VALEUR RENVOYÉE

       En cas de réussite, ces fonctions renvoient le reste en virgule flottante,  x-n*y.  Si  la
       valeur de retour est nulle, elle a le signe de x.

       Si x ou y est un NaN, un NaN est renvoyé.

       Si  x  est  infini  et  y n'est pas un NaN, une erreur de domaine se produit et un NaN est
       renvoyé.

       Si y est nul et x n'est pas un NaN, une erreur  de  domaine  se  produit  et  un  NaN  est
       renvoyé.

ERREURS

       Consultez  math_error(7) pour savoir comment déterminer qu'une erreur est survenue lors de
       l'appel de ces fonctions.

       Les erreurs suivantes peuvent se produire :

       Erreur de domaine : x est infini et y n'est pas un NaN
              Une exception indiquant une virgule flottante incorrecte (FE_INVALID) est levée.

              Ces fonctions ne positionnent pas errno dans ce cas.

       Erreur de domaine : y est nul.
              errno  prend  la  valeur  EDOM.  Une  exception  indiquant  une  virgule  flottante
              incorrecte (FE_INVALID) est levée.

CONFORMITÉ

       Les  fonctions  remainder(),  remainderf()  et  remainderl()  sont  spécifiées dans C99 et
       POSIX.1-2001.

       La fonction drem() vient de BSD 4.3. Les variantes float et long double dremf() et dreml()
       existent  sur  certains  systèmes,  comme Tru64 et glibc2. Évitez d'utiliser ces fonctions
       pour leur préférer remainder() etc.

BOGUES

       L'appel

           remainder(nan(""), 0);

       renvoie un NaN, comme attendu, mais cause à tort une erreur de domaine ; il devrait  juste
       renvoyer un NaN.

EXEMPLE

       L'appel « remainder(29.0, 3.0) » renvoie -1.

VOIR AUSSI

       div(3), fmod(3), remquo(3)

COLOPHON

       Cette  page  fait partie de la publication 3.57 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Alain   Portal  <http://manpagesfr.free.fr/> (2004-2006).  Nicolas  François  et  l'équipe
       francophone de traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».

                                        20 septembre 2010                            REMAINDER(3)