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
C99, POSIX.1-2001, POSIX.1-2008.

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

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