lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam

#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():

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.

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.

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.

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.

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.

tgamma(3)

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

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