log1p, log1pf, log1pl

計算 1 加上指定值的自然對數。

語法

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

參數

x
浮點引數。

傳回值

如果成功，則傳回 （+ 1） 的自然 （base-e ） 記錄 x 。

否則，可能會傳回下列其中一個值：

輸入	結果	SEH 例外狀況	errno
+INF	+INF
非正規數	與輸入相同	UNDERFLOW
±0	與輸入相同
-1	-Inf	DIVBYZERO	ERANGE
< -1	NaN	INVALID	EDOM
-Inf	NaN	INVALID	EDOM
±SNaN	與輸入相同	INVALID
±QNaN，無限期	與輸入相同

如果 x = -1，errno 值會設定為 ERANGE。 如果 <x -1，此值 errno 會設定為 EDOM 。

備註

函 log1p 式可能比接近 0 時 x 使用 log(x + 1) 更精確。

因為 C++ 允許多載，所以您可以呼叫採用並傳回 log1p 和 float 類型的 long double 的多載。 在 C 程式中，除非您使用 < tgmath.h > 宏來呼叫此函式， log1p 否則一律會採用 並傳 double 回 。

如果您使用 <tgmath.h>log1p() 宏，引數的類型會決定選取哪一個函式版本。 如需詳細資訊，請參閱 類型泛型數學 。

其中 x 是自然數位，此函式會傳回 + 1 的 x 基底 e 對數。

根據預設，此函式的全域狀態會限定于應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

需求

函式	C 標頭	C++ 標頭
log1p, log1pf, log1pl	<math.h>	<cmath>
log1p 宏觀	<tgmath.h>

如需相容性詳細資訊，請參閱相容性。

另請參閱

字母函數參考
log2, log2f, log2l
log, logf, log10, log10f