BEZEICHNUNG

       lgamma,   lgammaf,  lgammal,  lgamma_r,  lgammaf_r,  lgammal_r,  signgam  -  Gammafunktion
       protokollieren

ÜBERSICHT

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

       Linken Sie mit der Option -lm.

   Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

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

BESCHREIBUNG

       Die Definition der Gammafunktion finden Sie unter tgamma(3).

       Die Funktion lgamma() gibt den natürlichen  Logarithmus  des  Betrages  der  Gammafunktion
       zurück.   Das   Vorzeichen  der  Gammafunktion  wird  in  der  externen  Ganzzahl  signgam
       zurückgegeben, die in <math.h> deklariert ist. Sie ist 1, wenn die  Gammafunktion  positiv
       oder Null ist und -1, wenn sie negativ ist.

       Da  die  Benutzung eines konstanten signgam-Ortes nicht sicher für Threads ist, wurden die
       Funktionen lgamma_r() etc. eingeführt; sie geben das Vorzeichen über  das  Argument  signp
       zurück.

RÜCKGABEWERT

       Bei Erfolg geben diese Funktionen den natürlichen Logarithmus von Gamma(x) zurück.

       Falls x keine zulässige Zahl (»NaN«) ist, wird »NaN« zurückgegeben.

       Falls x 1 oder 2 ist, wird +0 zurückgegeben.

       Falls   x   positiv   unendlich   oder  negativ  unendlich  ist,  wird  positiv  unendlich
       zurückgegeben.

       Falls x eine  nicht  positive  Ganzzahl  ist,  tritt  ein  Polstellenfehler  auf  und  die
       Funktionen geben +HUGE_VAL, +HUGE_VALF beziehungsweise +HUGE_VALL zurück.

       Bei einem Ergebnisüberlauf tritt ein Bereichsfehler auf und die Funktionen geben HUGE_VAL,
       HUGE_VALF beziehungsweise HUGE_VALL mit dem korrekten Vorzeichen zurück.

FEHLER

       In math_error(7) erfahren Sie, wie Sie Fehler bei der Ausführung mathematischer Funktionen
       erkennen.

       Die folgenden Fehler können auftreten:

       Polstellenfehler: x ist eine nicht positive Ganzzahl.
              errno    wird   auf   ERANGE   gesetzt   (siehe   aber   FEHLER).   Es   wird   der
              Fließkomma-Ausnahmefehler »Division durch Null« (FE_DIVBYZERO) ausgelöst.

       Bereichsfehler: Ergebnisüberlauf
              errno wird auf ERANGE gesetzt. Es  wird  der  Fließkomma-Ausnahmefehler  »Überlauf«
              (FE_OVERFLOW) ausgelöst.

KONFORM ZU

       Die  lgamma()-Funktionen  sind  in  C99  und  POSIX.1-2001  spezifiziert.  signgam  ist in
       POSIX.1-2001 spezifiziert,  aber  nicht  in  C99.  Die  lgamma_r()-Funktionen  sind  nicht
       Standard, aber auf mehreren anderen Systemen vorhanden.

FEHLER

       Bis  einschließlich  Glibc  2.9  wurde,  wenn ein Polstellenfehler auftrat, errno auf EDOM
       statt des von POSIX vorgeschriebenen ERANGE gesetzt.  Seit  Version  2.10  tut  Glibc  das
       Richtige.

SIEHE AUCH

       tgamma(3)

KOLOPHON

       This  page  is  part  of release 3.54 of the Linux man-pages project. A description of the
       project,    and    information    about    reporting    bugs,    can    be    found     at
       http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Markus Schmitt <fw@math.uni-sb.de>
       und Chris Leick <c.leick@vollbio.de> erstellt.

       Diese Übersetzung ist Freie Dokumentation;  lesen  Sie  die  GNU  General  Public  License
       Version   3  oder  neuer  bezüglich  der  Copyright-Bedingungen.  Es  wird  KEINE  HAFTUNG
       übernommen.

       Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-
       Mail an <debian-l10n-german@lists.debian.org>.

                                        11. September 2010                              LGAMMA(3)