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 に設定されます。 値は errno -1 の場合x<にEDOM設定されます。

解説

関数はlog1p、0 に近い場合xよりもlog(x + 1)正確な場合があります。

C++ ではオーバーロードが可能であるため、log1p 型および float 型を受け取って返す long double のオーバーロードを呼び出すことができます。 C プログラムでは、tgmath.h マクロを<使用してこの関数を呼び出していない限り、log1p常に double.>

<tgmath.h>log1p() マクロを使用する場合は、引数の型によって、選択される関数のバージョンが決定されます。 詳細については、「ジェネリック型数値演算」を参照してください。

ここで x 、自然数は、この関数は + 1 の底 e 対数を x 返します。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

機能	C ヘッダー	C++ ヘッダー
log1p, log1pf, log1pl	<math.h>	<cmath>
log1p マクロ	<tgmath.h>

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

アルファベット順関数リファレンス
log2, log2f, log2l
log, logf, log10, log10f