BEZEICHNUNG

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

BIBLIOTHEK

       Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT

       #include <math.h>

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

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

       extern int signgam;

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       lgamma():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE
               || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

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

       lgamma_r(), lgammaf_r(), lgammal_r():
           /* Since Glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

       signgam:
           _XOPEN_SOURCE
               || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

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

       Die  Funktionen  lgamma(),  lgammaf()  und  lgammal()  geben 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  multithread-fähig  ist,  wurden  die  Funktionen
       lgamma_r(),  lgammaf_r()  und  lgammal_r()  eingeführt;  sie geben das Vorzeichen über das Argument vorzz
       zurück.

RÜCKGABEWERT

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

       Falls x keine 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.

       Falls  das  Ergebnis überläuft, tritt ein Bereichsfehler auf und die Funktionen geben HUGE_VAL, HUGE_VALF
       beziehungsweise HUGE_VALL mit dem korrekten mathematischen Vorzeichen zurück.

FEHLER

       In math_error(7) erfahren Sie, wie Sie Fehler bei der Ausführung dieser 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  ein  Fließkomma-Ausnahmefehler  »Überlauf«  (FE_OVERFLOW)
              ausgelöst.

STANDARDS

       lgamma()
       lgammaf()
       lgammal()
              C11, POSIX.1-2008.

       signgam
              POSIX.1-2008.

       lgamma_r()
       lgammaf_r()
       lgammal_r()
              Keine.

GESCHICHTE

       lgamma()
       lgammaf()
       lgammal()
              C99, POSIX.1-2001.

       signgam
              POSIX.1-2001.

       lgamma_r()
       lgammaf_r()
       lgammal_r()
              Keine.

FEHLER

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

SIEHE AUCH

       tgamma(3)

Ü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 die
       Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.

Linux man-pages 6.9.1                              2. Mai 2024                                         lgamma(3)