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 *signp);
float lgammaf_r(float x, int *signp);
long double lgammal_r(long double x, int *signp);

extern int signgam;

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 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.

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 der Fließkomma-Ausnahmefehler »Überlauf« (FE_OVERFLOW) ausgelöst.

STANDARDS¶

Die lgamma()-Funktionen sind in C99, POSIX.1-2001 und POSIX.1-2008 spezifiziert. signgam ist in POSIX.1-2001 und POSIX.1-2008 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 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.