lgamma(3)

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;

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