計算 1 加上指定值的自然對數。
語法
double log1p(double x);
float log1pf(float x);
long double log1pl(long double x);
#define log1p(X) // Requires C11 or later
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> |
如需相容性詳細資訊，請參閱相容性。