X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=release%2Fman3%2Ftgamma.3;h=bdf03301230133de7ed0e74be9ed318b15460460;hb=c1dfa2f6ab1bbed84992d3c59ee9925f4d453668;hp=5e35e0b084ef078dd57cf2c0aadad5aeddb9a230;hpb=633a2252e0be3c867dce264a180a89ce8181d36f;p=linuxjm%2FLDP_man-pages.git diff --git a/release/man3/tgamma.3 b/release/man3/tgamma.3 index 5e35e0b0..bdf03301 100644 --- a/release/man3/tgamma.3 +++ b/release/man3/tgamma.3 @@ -1,179 +1,128 @@ .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de) +.\" +.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE) .\" Distributed under GPL +.\" %%%LICENSE_END +.\" .\" Based on glibc infopages .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk .\" .\" Modified 2004-11-15, fixed error noted by Fabian Kreutz .\" .\" -.\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI -.\" all rights reserved. -.\" Translated Sun Sep 22 09:31:52 2002 -.\" by Akihiro MOTOKI -.\" Updated & Modified Sat Feb 12 12:00:00 2005 -.\" by SAITOH Akira -.\" Updated 2008-09-16, Akihiro MOTOKI +.\"******************************************************************* .\" -.TH TGAMMA 3 2008-08-11 "GNU" "Linux Programmer's Manual" -.SH ̾Á° -tgamma, tgammaf, tgammal \- ËÜÅö¤Î¥¬¥ó¥Þ´Ø¿ô -.SH ½ñ¼° -.B #include +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH TGAMMA 3 2010\-09\-20 GNU "Linux Programmer's Manual" +.SH 名前 +tgamma, tgammaf, tgammal \- 本当のガンマ関数 +.SH 書式 +\fB#include \fP .sp -.BI "double tgamma(double " x ); +\fBdouble tgamma(double \fP\fIx\fP\fB);\fP .br -.BI "float tgammaf(float " x ); +\fBfloat tgammaf(float \fP\fIx\fP\fB);\fP .br -.BI "long double tgammal(long double " x ); +\fBlong double tgammal(long double \fP\fIx\fP\fB);\fP .sp -\fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£ +\fI\-lm\fP でリンクする。 .sp .in -4n -Feature Test Macro Requirements for glibc (see -.BR feature_test_macros (7)): +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): .in .sp .ad l -.BR tgamma (), -.BR tgammaf (), -.BR tgammal (): -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or -.I cc\ -std=c99 -.ad b -.SH ÀâÌÀ -¥¬¥ó¥Þ´Ø¿ô¤Ï°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤ë: +\fBtgamma\fP(), \fBtgammaf\fP(), \fBtgammal\fP(): +.RS 4 +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L; +.br +or \fIcc\ \-std=c99\fP +.RE +.ad +.SH 説明 +ガンマ関数は以下のように定義される: .sp - Gamma(x) = t^(x\-1) e^\-t dt ¤Î 0 ¤«¤é̵¸ÂÂç¤Þ¤Ç¤ÎÀÑʬ + Gamma(x) = t^(x\-1) e^\-t dt の 0 から無限大までの積分 .sp -¤³¤Î´Ø¿ô¤ÏÀµ¤Ç¤Ê¤¤À°¿ô¤ò½ü¤¯¤¹¤Ù¤Æ¤Î¼Â¿ô¤ËÂФ·¤ÆÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£ -ÈóÉé¤ÎÀ°¿ô \fIm\fP ¤Ë´Ø¤·¤Æ¡¢°Ê²¼¤¬À®Î©¤¹¤ë: +この関数は正でない整数を除くすべての実数に対して定義されている。 非負の整数 \fIm\fP に関して、以下が成立する: .sp Gamma(m+1) = m! .sp -¤è¤ê°ìÈÌŪ¤Ë¤Ï¡¢¤¹¤Ù¤Æ¤Î \fIx\fP ¤Ë´Ø¤·¤Æ°Ê²¼¤¬À®Î©¤¹¤ë: +より一般的には、すべての \fIx\fP に関して以下が成立する: .sp Gamma(x+1) = x * Gamma(x) .sp -¤µ¤é¤Ë¡¢¶Ë¤ò½ü¤¯¤¹¤Ù¤Æ¤Î \fIx\fP ¤Ç¼¡¼°¤âÀ®Î©¤¹¤ë: +さらに、極を除くすべての \fIx\fP で次式も成立する: .sp Gamma(x) * Gamma(1 \- x) = PI / sin(PI * x) .PP -.SH ÊÖ¤êÃÍ -À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï Gamma(x) ¤òÊÖ¤¹¡£ +.SH 返り値 +成功すると、これらの関数は Gamma(x) を返す。 -.I x -¤¬ NaN ¤Î¾ì¹ç¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP が NaN の場合、NaN が返される。 -.I x -¤¬Àµ¤Î̵¸ÂÂç¤Î¾ì¹ç¡¢Àµ¤Î̵¸ÂÂ礬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP が正の無限大の場合、正の無限大が返される。 -.I x -¤¬Éé¤ÎÀ°¿ô¤«Éé¤Î̵¸ÂÂç¤Î¾ì¹ç¡¢Îΰ襨¥é¡¼ (domain error) ¤¬È¯À¸¤·¡¢ -NaN ¤¬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP が負の整数か負の無限大の場合、領域エラー (domain error) が発生し、 NaN が返される。 -·ë²Ì¤¬¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ÈÏ°Ï¥¨¥é¡¼ (range error) ¤¬È¯À¸¤·¡¢ -³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì -.BR HUGE_VAL , -.BR HUGE_VALF , -.BR HUGE_VALL , -¤òÊÖ¤¹¡£¤³¤ÎºÝ¡¢¿ô³ØŪ¤ËÀµ¤·¤¤Éä¹æ¤¬ÉÕÍ¿¤µ¤ì¤ë¡£ +結果がオーバーフローする場合、範囲エラー (range error) が発生し、 各関数はそれぞれ \fBHUGE_VAL\fP, \fBHUGE_VALF\fP, +\fBHUGE_VALL\fP, を返す。この際、数学的に正しい符号が付与される。 -·ë²Ì¤¬¥¢¥ó¥À¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ÈÏ°Ï¥¨¥é¡¼ (range error) ¤¬È¯À¸¤·¡¢ -´Ø¿ô¤Ï 0 ¤ò¤òÊÖ¤¹¡£¤³¤ÎºÝ¡¢¿ô³ØŪ¤ËÀµ¤·¤¤Éä¹æ¤¬ÉÕÍ¿¤µ¤ì¤ë¡£ +結果がアンダーフローする場合、範囲エラー (range error) が発生し、 関数は 0 をを返す。この際、数学的に正しい符号が付与される。 -.I x -¤¬ \-0 ¤« +0 ¤Î¾ì¹ç¡¢¶Ë¥¨¥é¡¼ (pole error) ¤¬È¯À¸¤·¡¢ -³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì -.BR HUGE_VAL , -.BR HUGE_VALF , -.BR HUGE_VALL , -¤òÊÖ¤¹¡£ -0 ¤ÈƱ¤¸Éä¹æ¤¬ÉÕÍ¿¤µ¤ì¤ë¡£ -.SH ¥¨¥é¡¼ -¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¤«¤ÎȽÄêÊýË¡¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤Ï -.BR math_error (7) -¤ò»²¾È¤Î¤³¤È¡£ +\fIx\fP が \-0 か +0 の場合、極エラー (pole error) が発生し、 各関数はそれぞれ \fBHUGE_VAL\fP, +\fBHUGE_VALF\fP, \fBHUGE_VALL\fP, を返す。 0 と同じ符号が付与される。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 .PP -°Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ­¤¬¤¢¤ë¡£ -.TP -Îΰ襨¥é¡¼: \fIx\fP ¤¬Éé¤ÎÀ°¿ô¤«Éé¤Î̵¸ÂÂç +以下のエラーが発生する可能性がある。 +.TP +領域エラー: \fIx\fP が負の整数か負の無限大 .\" FIXME . errno is not set to EDOM for x == -inf .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809 -.I errno -¤Ë -.B EDOM -¤¬ÀßÄꤵ¤ì¤ë¡£ -ÉÔÀµ (invalid) ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_INVALID ) -¤¬¾å¤¬¤ë (¡Ö¥Ð¥°¡×¤ÎÀá¤ò»²¾È)¡£ -.TP -¶Ë¥¨¥é¡¼ (pole error): \fIx\fP ¤¬ +0 ¤« \-0 -.I errno -¤Ë -.B ERANGE -¤¬ÀßÄꤵ¤ì¤ë¡£ -0 ¤Ë¤è¤ë½ü»» (divide-by-zero) ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_DIVBYZERO ) -¤¬¾å¤¬¤ë¡£ -.TP -ÈÏ°Ï¥¨¥é¡¼ (range error): ·ë²Ì¤Î¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ -.I errno -¤Ë -.B ERANGE -¤¬ÀßÄꤵ¤ì¤ë¡£ -¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_OVERFLOW ) -¤¬¾å¤¬¤ë¡£ +\fIerrno\fP に \fBEDOM\fP が設定される。 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP) が上がる +(「バグ」の節を参照)。 +.TP +極エラー (pole error): \fIx\fP が +0 か \-0 +\fIerrno\fP に \fBERANGE\fP が設定される。 0 による除算 (divide\-by\-zero) 浮動小数点例外 +(\fBFE_DIVBYZERO\fP) が上がる。 +.TP +範囲エラー (range error): 結果のオーバーフロー +\fIerrno\fP に \fBERANGE\fP が設定される。 オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP) が上がる。 .PP -glibc ¤Ç¤Ï¡¢C99 ¤ä POSIX.1-2001 ¤Çµ¬Äꤵ¤ì¤Æ¤¤¤Ê¤¤°Ê²¼¤Î¥¨¥é¡¼¤â -µ¯¤³¤êÆÀ¤ë¡£ -.TP -ÈÏ°Ï¥¨¥é¡¼ (range error): ·ë²Ì¤Î¥¢¥ó¥À¡¼¥Õ¥í¡¼ +glibc では、C99 や POSIX.1\-2001 で規定されていない以下のエラーも 起こり得る。 +.TP +範囲エラー (range error): 結果のアンダーフロー .\" e.g., tgamma(-172.5) on glibc 2.8/x86-32 .\" .I errno .\" is set to .\" .BR ERANGE . -¥¢¥ó¥À¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_UNDERFLOW ) -¤¬¾å¤¬¤ë¡£ -¤³¤Î¾ì¹ç¤Ï -.I errno -¤ÏÀßÄꤵ¤ì¤Ê¤¤¡£ +アンダーフロー浮動小数点例外 (\fBFE_UNDERFLOW\fP) が上がる。 +.IP .\" FIXME . Is it intentional that errno is not set: .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810 .\" .\" glibc (as at 2.8) also supports and an inexact .\" exception for various cases. -.SH ¥Ð¡¼¥¸¥ç¥ó -¤³¤ì¤é¤Î´Ø¿ô¤Ï glibc ¥Ð¡¼¥¸¥ç¥ó 2.1 ¤Ç½é¤á¤ÆÅо줷¤¿¡£ -.SH ½àµò -C99, POSIX.1-2001. -.SH Ãí°Õ -¤³¤Î´Ø¿ô¤ò¡ÖËÜÅö¤Î (true) ¥¬¥ó¥Þ´Ø¿ô¡×¤È¸Æ¤Ð¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤«¤Ã¤¿¡£ -¤Ê¤¼¤Ê¤é¡¢Â¾¤ÎÃͤòÊÖ¤¹ -.BR gamma (3) -¤È¤¤¤¦´Ø¿ô¤¬¤¹¤Ç¤Ë¸ºß¤¹¤ë¤«¤é¤Ç¤¢¤ë (¾ÜºÙ¤Ë¤Ä¤¤¤Æ¤Ï -.BR gamma (3) -¤ò»²¾È)¡£ -.SH ¥Ð¥° -.I x -¤¬Éé¤Î̵¸ÂÂç¤Î¾ì¹ç¡¢ -.I errno -¤ÏÀßÄꤵ¤ì¤Ê¤¤ -.RB ( EDOM -¤¬ÀßÄꤵ¤ì¤ë¤Ù¤­¤Ç¤¢¤ë)¡£ +この場合は \fIerrno\fP は設定されない。 +.SH バージョン +これらの関数は glibc バージョン 2.1 で初めて登場した。 +.SH 準拠 +C99, POSIX.1\-2001. +.SH 注意 +この関数を「本当の (true) ガンマ関数」と呼ばなければならなかった。 なぜなら、他の値を返す \fBgamma\fP(3) +という関数がすでに存在するからである (詳細については \fBgamma\fP(3) を参照)。 +.SH バグ .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809 +\fIx\fP が負の無限大の場合、 \fIerrno\fP は設定されない (\fBEDOM\fP が設定されるべきである)。 -glibc ¥Ð¡¼¥¸¥ç¥ó 2.3.3 °ÊÁ°¤Ç¤Ï¡¢ -°ú¤­¿ô¤Ë +0 ¤ä \-0 ¤òÅϤ¹¤È¡¢¶Ë¥¨¥é¡¼¤Ç¤Ï¤Ê¤¯¡¢ -Îΰ襨¥é¡¼¤ò´Ö°ã¤Ã¤ÆȯÀ¸¤·¤Æ¤¤¤¿ -(Îΰ襨¥é¡¼¤Î¾ì¹ç¡¢ -.I errno -¤Ë -.B EDOM -¤òÀßÄꤵ¤ì¡¢ -.B FE_INVALID -Îã³°¤¬È¯À¸¤¹¤ë)¡£ -.SH ´ØÏ¢¹àÌÜ -.BR gamma (3), -.BR lgamma (3) +glibc バージョン 2.3.3 以前では、 引き数に +0 や \-0 を渡すと、極エラーではなく、 領域エラーを間違って発生していた +(領域エラーの場合、 \fIerrno\fP に \fBEDOM\fP を設定され、 \fBFE_INVALID\fP 例外が発生する)。 +.SH 関連項目 +\fBgamma\fP(3), \fBlgamma\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。