release/man3/tgamma.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL
   3 .\" Based on glibc infopages
   4 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
   5 .\"     <mtk.manpages@gmail.com>
   6 .\" Modified 2004-11-15, fixed error noted by Fabian Kreutz
   7 .\"      <kreutz@dbs.uni-hannover.de>
   8 .\"
   9 .\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI
  10 .\"         all rights reserved.
  11 .\" Translated Sun Sep 22 09:31:52 2002
  12 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  13 .\" Updated & Modified Sat Feb 12 12:00:00 2005
  14 .\"         by SAITOH Akira <s-akira@users.sourceforge.net>
  15 .\" Updated 2008-09-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  16 .\"
  17 .TH TGAMMA 3 2010-09-20 "GNU" "Linux Programmer's Manual"
  18 .SH Ì¾Á°
  19 tgamma, tgammaf, tgammal \- ËÜÅö¤Î¥¬¥ó¥Þ´Ø¿ô
  20 .SH ½ñ¼°
  21 .B #include <math.h>
  22 .sp
  23 .BI "double tgamma(double " x );
  24 .br
  25 .BI "float tgammaf(float " x );
  26 .br
  27 .BI "long double tgammal(long double " x );
  28 .sp
  29 \fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
  30 .sp
  31 .in -4n
  32 glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
  33 .RB ( feature_test_macros (7)
  34 »²¾È):
  35 .in
  36 .sp
  37 .ad l
  38 .BR tgamma (),
  39 .BR tgammaf (),
  40 .BR tgammal ():
  41 .RS 4
  42 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
  43 _POSIX_C_SOURCE\ >=\ 200112L;
  44 .br
  45 or
  46 .I cc\ -std=c99
  47 .RE
  48 .ad
  49 .SH ÀâÌÀ
  50 ¥¬¥ó¥Þ´Ø¿ô¤Ï°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤ë:
  51 .sp
  52      Gamma(x) = t^(x\-1) e^\-t dt ¤Î 0 ¤«¤éÌµ¸ÂÂç¤Þ¤Ç¤ÎÀÑÊ¬
  53 .sp
  54 ¤³¤Î´Ø¿ô¤ÏÀµ¤Ç¤Ê¤¤À°¿ô¤ò½ü¤¯¤¹¤Ù¤Æ¤Î¼Â¿ô¤ËÂÐ¤·¤ÆÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
  55 ÈóÉé¤ÎÀ°¿ô \fIm\fP ¤Ë´Ø¤·¤Æ¡¢°Ê²¼¤¬À®Î©¤¹¤ë:
  56 .sp
  57     Gamma(m+1) = m!
  58 .sp
  59 ¤è¤ê°ìÈÌÅª¤Ë¤Ï¡¢¤¹¤Ù¤Æ¤Î \fIx\fP ¤Ë´Ø¤·¤Æ°Ê²¼¤¬À®Î©¤¹¤ë:
  60 .sp
  61     Gamma(x+1) = x * Gamma(x)
  62 .sp
  63 ¤µ¤é¤Ë¡¢¶Ë¤ò½ü¤¯¤¹¤Ù¤Æ¤Î \fIx\fP ¤Ç¼¡¼°¤âÀ®Î©¤¹¤ë:
  64 .sp
  65     Gamma(x) * Gamma(1 \- x) = PI / sin(PI * x)
  66 .PP
  67 .SH ÊÖ¤êÃÍ
  68 À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï Gamma(x) ¤òÊÖ¤¹¡£
  69
  70 .I x
  71 ¤¬ NaN ¤Î¾ì¹ç¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
  72
  73 .I x
  74 ¤¬Àµ¤ÎÌµ¸ÂÂç¤Î¾ì¹ç¡¢Àµ¤ÎÌµ¸ÂÂç¤¬ÊÖ¤µ¤ì¤ë¡£
  75
  76 .I x
  77 ¤¬Éé¤ÎÀ°¿ô¤«Éé¤ÎÌµ¸ÂÂç¤Î¾ì¹ç¡¢ÎÎ°è¥¨¥é¡¼ (domain error) ¤¬È¯À¸¤·¡¢
  78 NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
  79
  80 ·ë²Ì¤¬¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ÈÏ°Ï¥¨¥é¡¼ (range error) ¤¬È¯À¸¤·¡¢
  81 ³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì
  82 .BR HUGE_VAL ,
  83 .BR HUGE_VALF ,
  84 .BR HUGE_VALL ,
  85 ¤òÊÖ¤¹¡£¤³¤ÎºÝ¡¢¿ô³ØÅª¤ËÀµ¤·¤¤Éä¹æ¤¬ÉÕÍ¿¤µ¤ì¤ë¡£
  86
  87 ·ë²Ì¤¬¥¢¥ó¥À¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ÈÏ°Ï¥¨¥é¡¼ (range error) ¤¬È¯À¸¤·¡¢
  88 ´Ø¿ô¤Ï 0 ¤ò¤òÊÖ¤¹¡£¤³¤ÎºÝ¡¢¿ô³ØÅª¤ËÀµ¤·¤¤Éä¹æ¤¬ÉÕÍ¿¤µ¤ì¤ë¡£
  89
  90 .I x
  91 ¤¬ \-0 ¤« +0 ¤Î¾ì¹ç¡¢¶Ë¥¨¥é¡¼ (pole error) ¤¬È¯À¸¤·¡¢
  92 ³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì
  93 .BR HUGE_VAL ,
  94 .BR HUGE_VALF ,
  95 .BR HUGE_VALL ,
  96 ¤òÊÖ¤¹¡£
  97 0 ¤ÈÆ±¤¸Éä¹æ¤¬ÉÕÍ¿¤µ¤ì¤ë¡£
  98 .SH ¥¨¥é¡¼
  99 ¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¤«¤ÎÈ½ÄêÊýË¡¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤Ï
 100 .BR math_error (7)
 101 ¤ò»²¾È¤Î¤³¤È¡£
 102 .PP
 103 °Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄÇ½À¤¬¤¢¤ë¡£
 104 .TP
 105 ÎÎ°è¥¨¥é¡¼: \fIx\fP ¤¬Éé¤ÎÀ°¿ô¤«Éé¤ÎÌµ¸ÂÂç
 106 .\" FIXME . errno is not set to EDOM for x == -inf
 107 .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809
 108 .I errno
 109 ¤Ë
 110 .B EDOM
 111 ¤¬ÀßÄê¤µ¤ì¤ë¡£
 112 ÉÔÀµ (invalid) ÉâÆ°¾®¿ôÅÀÎã³°
 113 .RB ( FE_INVALID )
 114 ¤¬¾å¤¬¤ë (¡Ö¥Ð¥°¡×¤ÎÀá¤ò»²¾È)¡£
 115 .TP
 116 ¶Ë¥¨¥é¡¼ (pole error): \fIx\fP ¤¬ +0 ¤« \-0
 117 .I errno
 118 ¤Ë
 119 .B ERANGE
 120 ¤¬ÀßÄê¤µ¤ì¤ë¡£
 121 0 ¤Ë¤è¤ë½ü»» (divide-by-zero) ÉâÆ°¾®¿ôÅÀÎã³°
 122 .RB ( FE_DIVBYZERO )
 123 ¤¬¾å¤¬¤ë¡£
 124 .TP
 125 ÈÏ°Ï¥¨¥é¡¼ (range error): ·ë²Ì¤Î¥ª¡¼¥Ð¡¼¥Õ¥í¡¼
 126 .I errno
 127 ¤Ë
 128 .B ERANGE
 129 ¤¬ÀßÄê¤µ¤ì¤ë¡£
 130 ¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³°
 131 .RB ( FE_OVERFLOW )
 132 ¤¬¾å¤¬¤ë¡£
 133 .PP
 134 glibc ¤Ç¤Ï¡¢C99 ¤ä POSIX.1-2001 ¤Çµ¬Äê¤µ¤ì¤Æ¤¤¤Ê¤¤°Ê²¼¤Î¥¨¥é¡¼¤â
 135 µ¯¤³¤êÆÀ¤ë¡£
 136 .TP
 137 ÈÏ°Ï¥¨¥é¡¼ (range error): ·ë²Ì¤Î¥¢¥ó¥À¡¼¥Õ¥í¡¼
 138 .\" e.g., tgamma(-172.5) on glibc 2.8/x86-32
 139 .\" .I errno
 140 .\" is set to
 141 .\" .BR ERANGE .
 142 ¥¢¥ó¥À¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³°
 143 .RB ( FE_UNDERFLOW )
 144 ¤¬¾å¤¬¤ë¡£
 145 ¤³¤Î¾ì¹ç¤Ï
 146 .I errno
 147 ¤ÏÀßÄê¤µ¤ì¤Ê¤¤¡£
 148 .\" FIXME . Is it intentional that errno is not set:
 149 .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810
 150 .\"
 151 .\" glibc (as at 2.8) also supports and an inexact
 152 .\" exception for various cases.
 153 .SH ¥Ð¡¼¥¸¥ç¥ó
 154 ¤³¤ì¤é¤Î´Ø¿ô¤Ï glibc ¥Ð¡¼¥¸¥ç¥ó 2.1 ¤Ç½é¤á¤ÆÅÐ¾ì¤·¤¿¡£
 155 .SH ½àµò
 156 C99, POSIX.1-2001.
 157 .SH Ãí°Õ
 158 ¤³¤Î´Ø¿ô¤ò¡ÖËÜÅö¤Î (true) ¥¬¥ó¥Þ´Ø¿ô¡×¤È¸Æ¤Ð¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤«¤Ã¤¿¡£
 159 ¤Ê¤¼¤Ê¤é¡¢Â¾¤ÎÃÍ¤òÊÖ¤¹
 160 .BR gamma (3)
 161 ¤È¤¤¤¦´Ø¿ô¤¬¤¹¤Ç¤ËÂ¸ºß¤¹¤ë¤«¤é¤Ç¤¢¤ë (¾ÜºÙ¤Ë¤Ä¤¤¤Æ¤Ï
 162 .BR gamma (3)
 163 ¤ò»²¾È)¡£
 164 .SH ¥Ð¥°
 165 .I x
 166 ¤¬Éé¤ÎÌµ¸ÂÂç¤Î¾ì¹ç¡¢
 167 .I errno
 168 ¤ÏÀßÄê¤µ¤ì¤Ê¤¤
 169 .RB ( EDOM
 170 ¤¬ÀßÄê¤µ¤ì¤ë¤Ù¤¤Ç¤¢¤ë)¡£
 171 .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809
 172
 173 glibc ¥Ð¡¼¥¸¥ç¥ó 2.3.3 °ÊÁ°¤Ç¤Ï¡¢
 174 °ú¤¿ô¤Ë +0 ¤ä \-0 ¤òÅÏ¤¹¤È¡¢¶Ë¥¨¥é¡¼¤Ç¤Ï¤Ê¤¯¡¢
 175 ÎÎ°è¥¨¥é¡¼¤ò´Ö°ã¤Ã¤ÆÈ¯À¸¤·¤Æ¤¤¤¿
 176 (ÎÎ°è¥¨¥é¡¼¤Î¾ì¹ç¡¢
 177 .I errno
 178 ¤Ë
 179 .B EDOM
 180 ¤òÀßÄê¤µ¤ì¡¢
 181 .B FE_INVALID
 182 Îã³°¤¬È¯À¸¤¹¤ë)¡£
 183 .SH ´ØÏ¢¹àÌÜ
 184 .BR gamma (3),
 185 .BR lgamma (3)