lgamma, lgammaf, lgammal

判斷指定值之 gamma 函式絕對值的自然對數。

語法

double lgamma( double x );
float lgammaf( float x );
long double lgammal( long double x );
#define lgammal(X) // Requires C11 or higher

float lgamma( float x ); //C++ only
long double lgamma( long double x ); //C++ only

參數

x
要計算的值。

傳回值

如果成功，則傳回 的 gamma x 函式絕對值的自然對數。

問題	傳回
x = NaN	NaN
x = ±0	+INFINITY
x= 非負值整數	+INFINITY
±INFINITY	+INFINITY
極錯誤	+HUGE_VAL、+ HUGE_VALF 或 +HUGE_VALL
溢位範圍錯誤	HUGE_VAL±、± HUGE_VALF 或±HUGE_VALL

錯誤會回報為 中指定的 _matherr 。

備註

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

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

如果 x 是理性的數位，則此函式會傳回 （x - 1） 的乘積對數。

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

需求

函式	C 標頭	C++ 標頭
lgamma, lgammaf, lgammal	<math.h>	<cmath>
lgamma 宏觀	<tgmath.h>

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

另請參閱

字母函數參考
tgamma, tgammaf, tgammal