NOM

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

BIBLIOTHÈQUE

       Bibliothèque de math (libm, -lm)

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;

   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
               || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
               || /* Versions de la glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

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

       lgamma_r(), lgammaf_r(), lgammal_r() :
           /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
               || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

       signgam :
           _XOPEN_SOURCE
               || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
               || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

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

       Les fonctions lgamma(), lgammaf() et lgammal() 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(),  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.

STANDARDS

       Les fonctions lgamma() sont spécifiées dans C99 et POSIX.1-2001 et  POSIX.1-2008.  signgam
       est  spécifiée  dans  POSIX.1-2001  et  POSIX.1-2008,  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)

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  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   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⟩.