Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

NOM

       lgamma,  lgammaf,  lgammal,  lgamma_r,  lgammaf_r,  lgammal_r,  signgam - Logarithme de la
       fonction Gamma

SYNOPSIS

       #include <math.h>

       double lgamma(double x);
       float lgammaf(float x);
       long double lgammal(long double x);

       double lgamma_r(double x, int *signp);
       float lgammaf_r(float x, int *signp);
       long double lgammal_r(long double x, int *signp);

       extern int signgam;

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

       lgamma() :
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L
           ou cc -std=c99
       lgammaf(), lgammal() :
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L
           ou cc -std=c99
       lgamma_r(), lgammaf_r(), lgammal_r() :
           _BSD_SOURCE || _SVID_SOURCE
       signgam :
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE

DESCRIPTION

       Pour la définition de la fonction Gamma, consultez tgamma(3).

       La  fonction  lgamma() renvoie le logarithme népérien (ou naturel) de la valeur absolue de
       la fonction Gamma. Le signe de la fonction Gamma  est  stocké  dans  la  variable  entière
       externe  signgam  déclaré  dans  <math.h>.  Il vaut 1 si la fonction Gamma est positive ou
       nulle, -1 si elle est négative.

       Comme l'utilisation de la variable statique signgam n'est pas  sûre  en  multithread,  les
       fonctions  lgamma_r() etc. ont été introduites, elles renvoient le signe dans le paramètre
       signp.

VALEUR RENVOYÉE

       En cas de réussite, ces fonctions renvoient le logarithme népérien (ou logarithme naturel)
       de Gamma(x).

       Si x est un NaN, la valeur renvoyée est un NaN.

       Si x vaut 1 ou 2, +0 est renvoyé.

       Si  x  est  une  valeur  infinie  positive  ou  négative,  une valeur infinie positive est
       renvoyée.

       Si x est un nombre entier non-positif, une erreur de pôle  se  produit  et  les  fonctions
       renvoient +HUGE_VAL, +HUGE_VALF ou +HUGE_VALL, respectivement.

       En  cas  de  dépassement  pour  le  résultat,  une  erreur  d'intervalle se produit et les
       fonctions  renvoient  HUGE_VAL,  HUGE_VALF  ou  HUGE_VALL,  resp.  avec   le   bon   signe
       mathématique.

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 pôle : x est un nombre entier non-positif
              errno est configuré à la valeur ERANGE (mais consultez la section des BOGUES).  Une
              exception de virgule flottante division par zéro (FE_DIVBYZERO) est déclenchée.

       Erreur d'intervalle : dépassement pour le résultat
              errno  est  configurée  à ERANGE. Une exception de dépassement en virgule flottante
              (FE_OVERFLOW) est levée.

CONFORMITÉ

       Les fonctions lgamma() sont spécifiées dans C99 et  POSIX.1-2001.  signgam  est  spécifiée
       dans  POSIX.1-2001,  mais pas dans C99. Les fonctions lgamma_r() ne sont pas standardisées
       mais elles sont présentes sur de nombreux systèmes.

BOGUES

       Dans la glibc 2.9 et précédentes, lorsqu'une erreur de pôle se produit, errno est  définie
       à EDOM au lieu de ERANGE comme défini dans POSIX. C'est corrigé depuis la glibc 2.10.

VOIR AUSSI

       tgamma(3)

COLOPHON

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

TRADUCTION

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

       Christophe   Blaess   <URL:http://www.blaess.fr/christophe/>   (1996-2003),  Alain  Portal
       <URL:http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau 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> ».

                                        11 septembre 2010                               LGAMMA(3)