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> |
如需相容性詳細資訊,請參閱相容性。
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應