log1p, log1pf, log1pl

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, log1p übernimmt und gibt immer ein double.

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 "Typgenerika" .

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. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Anforderungen

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

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

Siehe auch

Alphabetische Funktionsreferenz
log2, log2f, log2l
log, logf, log10, log10f