BEZEICHNUNG

log1p, log1pf, log1pl - Logarithmus von 1 plus Argument

BIBLIOTHEK

Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT

#include <math.h>

double log1p(double x);
float log1pf(float x);
long double log1pl(long double x);

log1p():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
        || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

log1pf(), log1pl():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
        || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

Der Rückgabewert dieser Funktionen entspricht

    log (1 + x)

Das Ergebnis wird so berechnet, dass es auch dann genau ist, wenn der Wert von x nahe Null liegt.

RÜCKGABEWERT

Im Erfolgsfall liefern diese Funktionen den natürlichen Logarithmus von (1 + x) zurück.

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

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

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

Falls x kleiner als -1 (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 kleiner als -1.

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

Polfehler: x ist -1.

errno wird auf ERANGE gesetzt (siehe aber FEHLER). Es wird der 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.

FEHLER

Vor Glibc 2.22 hat die Glibc-Implementierung errno nicht auf EDOM gesetzt, wenn ein Bereichsfehler auftrat.

Vor Glibc 2.22 setzte die Glibc-Implementierung errno nicht auf ERANGE, wenn ein Bereichsfehler auftrat.

SIEHE AUCH

exp(3), expm1(3), log(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.