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;

       Éditer les liens avec -lm.

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

       lgamma() :
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE
               || /* Since glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
       lgammaf(), lgammal() :
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
               || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
               || /* Versions <= 2.19 de la glibc : */ _BSD_SOURCE || _SVID_SOURCE
       lgamma_r(), lgammaf_r(), lgammal_r() :
           /* Since glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
       signgam :
           _XOPEN_SOURCE
               || /* Since glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

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

       The  lgamma(),  lgammaf(), and lgammal()  functions return the natural logarithm of the absolute value of
       the Gamma function. The sign of the Gamma function is returned in the external integer  signgam  declared
       in <math.h>. It is 1 when the Gamma function is positive or zero, -1 when it is negative.

       Comme  l'utilisation  de  la  variable  statique  signgam  n'est  pas  sûre en multithread, les fonctions
       lgamma_r(), lgammaf_r() et lgammal_r() 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 n’est pas un nombre, un NaN est renvoyé.

       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

       Voir  math_error(7)  pour savoir comment déterminer si une erreur s'est produite lors de l'appel d'une 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  BOGUES).  Une  exception  de
              virgule flottante divisée par zéro (FE_DIVBYZERO) est déclenchée.

       Erreur de plage : débordement du résultat
              errno  est  configurée  à  ERANGE.  Une  exception de dépassement par le haut de virgule flottante
              (FE_OVERFLOW) est levée.

CONFORMITÉ

       The lgamma()  functions are specified in C99, POSIX.1-2001, and POSIX.1-2008.  signgam  is  specified  in
       POSIX.1-2001  and POSIX.1-2008, but not in C99. The lgamma_r()  functions are nonstandard, but present on
       several other systems.

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 5.10 du projet man-pages Linux. Une description du projet et des
       instructions  pour  signaler  des  anomalies et la dernière version de cette page peuvent être trouvées à
       l'adresse https://www.kernel.org/doc/man-pages/.

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> et Cédric Boutillier <cedric.boutillier@gmail.com>

       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.

                                                15 septembre 2017                                      LGAMMA(3)