リナックスコマンド

lgammaのヘルプ・マニュアル

日本語 英語

• help
• man

lgamma --help

man lgamma

LGAMMA(3) Linux Programmer’s Manual LGAMMA(3) 名前 lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam - ガ ンマ関数の対数を計算する 書式 #include double lgamma(double x); float lgammaf(float x); long double lgammal(long double x); double lgamma_r(double x, int *signp); float lgammaf_r(float x, int *signp); long double lgammal_r(long double x, int *signp); extern int signgam; -lm でリンクする。 glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照): lgamma(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE; or cc -std=c99 lgammaf(), lgammal(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE; or cc -std=c99 lgamma_r(), lgammaf_r(), lgammal_r(): _BSD_SOURCE || _SVID_SOURCE signgam: _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE 説明 ガンマ関数の定義については、 tgamma(3) を参照のこと。 関数 lgamma() は、ガンマ関数の絶対値の自然対数を返す。ガンマ関数の符 号 は 、 で宣言されている extern int signgam に格納される。格納さ れる値は、ガンマ関数が正または 0 の場合 1、負の場合 -1 である。 signgam という固定された場所を使うことはスレッドセーフではないので、 関 数 lgamma_r() な ど が導入されている。これらの関数では、符号は引き数 signp 経由で返される。 返り値 成功すると、これらの関数は Gamma(x) の自然対数を返す。 x が NaN の場合、NaN が返される。 x が 1 か 2 の場合、+0 が返される。 x が正の無限大か負の無限大の場合、正の無限大が返される。 x が正でない整数の場合、極エラー (pole error) が発生し、各関数はそれ ぞ れ +HUGE_VAL, +HUGE_VALF, +HUGE_VALL を返す。 結 果 が オ ー バーフローする場合、範囲エラーが発生し、各関数はそれぞれ HUGE_VAL, HUGE_VALF, HUGE_VALL を返す。返り値には数学的に正しい符号が付 与される。 エラー こ れらの関数を呼び出した際にエラーが発生したかの判定方法についての情報 は math_error(7) を参照のこと。 以下のエラーが発生する可能性がある。 極エラー: x が正でない整数 errno に ERANGE が設定される (「バグ」の節を参照)。 0 による除算 (divide-by-zero) 浮動小数点例外 (FE_DIVBYZERO) が上がる。 範囲エラー: 結果のオーバーフロー errno に ERANGE が 設定される。オーバーフロー浮動小数点例外 (FE_OVERFLOW) が上がる。 準拠 関数 lgamma() は C99 と POSIX.1-2001 で規定されてい る 。 signgam は POSIX.1-2001 で規定されているが、C99 にはない。関数 lgamma_r() は非標準 だが、いくつかの他のシステムにも存在する。 バグ 極エラーの場合、 errno に EDOM が設定される。 POSIX.1 では、 ERANGE が 設定されるべきとされている。 関連項目 tgamma(3) 2008-08-05 LGAMMA(3)

LGAMMA(3) Linux Programmer’s Manual LGAMMA(3) NAME lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam - log gamma function SYNOPSIS #include double lgamma(double x); float lgammaf(float x); long double lgammal(long double x); double lgamma_r(double x, int *signp); float lgammaf_r(float x, int *signp); long double lgammal_r(long double x, int *signp); extern int signgam; Link with -lm. Feature Test Macro Requirements for glibc (see feature_test_macros(7)): lgamma(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE; or cc -std=c99 lgammaf(), lgammal(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE; or cc -std=c99 lgamma_r(), lgammaf_r(), lgammal_r(): _BSD_SOURCE || _SVID_SOURCE signgam: _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE DESCRIPTION For the definition of the Gamma function, see tgamma(3). The lgamma() function returns the natural logarithm of the absolute value of the Gamma function. The sign of the Gamma function is returned in the external integer signgam declared in . It is 1 when the Gamma function is positive or zero, -1 when it is negative. Since using a constant location signgam is not thread-safe, the func- tions lgamma_r() etc. have been introduced; they return the sign via the argument signp. RETURN VALUE On success, these functions return the natural logarithm of Gamma(x). If x is a NaN, a NaN is returned. If x is 1 or 2, +0 is returned. If x is positive infinity or negative infinity, positive infinity is returned. If x is a non-positive integer, a pole error occurs, and the functions return +HUGE_VAL, +HUGE_VALF, or +HUGE_VALL, respectively. If the result overflows, a range error occurs, and the functions return HUGE_VAL, HUGE_VALF, or HUGE_VALL, respectively, with the correct math- ematical sign. ERRORS See math_error(7) for information on how to determine whether an error has occurred when calling these functions. The following errors can occur: Pole error: x is a non-positive integer errno is set to ERANGE (but see BUGS). A divide-by-zero float- ing-point exception (FE_DIVBYZERO) is raised. Range error: result overflow errno is set to ERANGE. An overflow floating-point exception (FE_OVERFLOW) is raised. CONFORMING TO The lgamma() functions are specified in C99 and POSIX.1-2001. signgam is specified in POSIX.1-2001, but not in C99. The lgamma_r() functions are non-standard, but present on several other systems. BUGS For a pole error, errno is set to EDOM; POSIX.1 says it should be set to ERANGE. SEE ALSO tgamma(3) COLOPHON This page is part of release 3.22 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/. 2008-08-05 LGAMMA(3)