log1p、 、 log1pflog1pl

計算 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、 、 log1pflog1pl	<math.h>	<cmath>
log1p 巨集	<tgmath.h>

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

另請參閱

依字母順序排列的函式參考
log2、 、 log2flog2l
log、 、 logf、 log10log10f