BEZEICHNUNG¶

log, logf, logl - natürliche Logarithmusfunktion

BIBLIOTHEK¶

Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT¶

#include <math.h>

double log(double x);
float logf(float x);
long double logl(long double x);

logf(), logl():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L


        || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE


        || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG¶

Diese Funktionen liefern den natürlichen Logarithmus von x zurück.

RÜCKGABEWERT¶

Im Erfolgsfall liefern diese Funktionen den natürlichen Logarithmus von x zurück.

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

Falls x 1 ist, dann ist das Ergebnis +0.

Falls x plus unendlich ist, wird plus unendlich zurückgegeben.

Falls x Null ist, tritt ein Polfehler auf und die Funktionen geben -HUGE_VAL, -HUGE_VALF beziehungsweise -HUGE_VALL zurück.

Falls x negativ (einschließlich negativ unendlich) ist, dann tritt ein Wertebereichsfehler auf und ein NaN (keine Zahl) wird zurückgeliefert.

FEHLER¶

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

Die folgenden Fehler können auftreten:

Wertebereichsfehler: x ist negativ

errno wird auf EDOM gesetzt. Es wird der Fließkomma-Ausnahmefehler »unzulässige Fließkommazahl« (FE_INVALID) ausgelöst.

Polfehler: x ist Null

errno wird auf ERANGE gesetzt. Es wird ein Fließkomma-Ausnahmefehler »Division durch Null« (FE_DIVBYZERO) ausgelöst.

ATTRIBUTE¶

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

STANDARDS¶

C11, POSIX.1-2008.

GESCHICHTE¶

C99, POSIX.1-2001.

Die Variante, die double zurückgibt, ist außerdem konform zu SVr4, 4.3BSD, C89.

FEHLER¶

In Glibc 2.5 und älter führte der Aufruf von log() mit einer NaN zu einer unechten ungültigen Fließkomma-Ausnahme (FE_INVALID).

SIEHE AUCH¶

cbrt(3), clog(3), log10(3), log1p(3), log2(3), sqrt(3)

ÜBERSETZUNG¶

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.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.