Freigeben über


log1p, log1pflog1pl

Berechnet den natürlichen Logarithmus von 1 plus den angegebenen Ausdruck.

Syntax

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

#define log1p(X) // Requires C11 or higher

float log1p(float x); //C++ only
long double log1p(long double x); //C++ only

Parameter

x
Das Gleitkommaargument.

Rückgabewert

Bei erfolgreicher Ausführung wird das natürliche (Basis-e)Protokoll von (x + 1) zurückgegeben.

Andernfalls wird möglicherweise einer der folgenden Werte zurückgeben:

Eingabe Ergebnis SEH-Ausnahme errno
+INF +INF
Abbrüche Identisch mit der Eingabe UNDERFLOW
±0 Identisch mit der Eingabe
-1 -INF DIVBYZERO ERANGE
< -1 NaN INVALID EDOM
-INF NaN INVALID EDOM
±SNaN Identisch mit der Eingabe INVALID
±QNaN, unbegrenzt Identisch mit der Eingabe

Der errno-Wert wird auf ERANGE festgelegt, wenn x=1. Der errno Wert wird auf EDOM " x< -1" festgelegt.

Hinweise

Die log1p Funktionen sind möglicherweise genauer als die Verwendung log(x + 1) , wenn x nahe 0 ist.

Da C++ das Überladen zulässt, können Sie Überladungen von log1p aufrufen, die float und long double-Typen verwenden und zurückgeben. In einem C-Programm, es sei denn, Sie verwenden das Makro <tgmath.h>, um diese Funktion aufzurufen, übernimmt log1p und gibt immer ein double zurück.

Wenn Sie das <tgmath.h> log1p() Makro verwenden, bestimmt der Typ des Arguments, welche Version der Funktion ausgewählt ist. Ausführliche Informationen finden Sie unter Typgengenerische Mathematik.

Ist x eine natürliche Zahl, gibt diese Funktion den Logarithmus der Basis ( x +1) zurück.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Anforderungen

Funktion C-Header C++-Header
log1p, log1pflog1pl <math.h> <cmath>
log1p-Makro <tgmath.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Weitere Informationen

Alphabetische Funktionsreferenz
log2, log2flog2l
log, , logflog10log10f