log(3)

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);

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

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 zulässige 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 Pol-Fehler 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.
Schnittstelle | Attribut | Wert
log(), logf(), logl() | Multithread-Fähigkeit | MT-Safe

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