draft/man3/gamma.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL
   3 .\"
   4 .\" Modified 2003-11-18, aeb: historical remarks
   5 .\"
   6 .\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI
   7 .\"         all rights reserved.
   8 .\" historical remarks: Japanese Version Copyright (c) 2005 SAITOH Akira
   9 .\"         all rights reserved.
  10 .\" Translated Sun Sep 22 08:34:42 2002
  11 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  12 .\" Updated & Modified Sat Feb 19 05:50:00 2005
  13 .\"         by SAITOH Akira <s-akira@users.sourceforge.net>
  14 .\" Updated 2008-09-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  15 .\"
  16 .TH GAMMA 3 2008-08-05 "GNU" "Linux Programmer's Manual"
  17 .\"O .SH NAME
  18 .\"O gamma, gammaf, gammal \- (logarithm of the) gamma function
  19 .SH 名前
  20 gamma, gammaf, gammal \- ガンマ関数 (の自然対数)
  21 .\"O .SH SYNOPSIS
  22 .SH 書式
  23 .B #include <math.h>
  24 .sp
  25 .BI "double gamma(double " x ");"
  26 .br
  27 .BI "float gammaf(float " x ");"
  28 .br
  29 .BI "long double gammal(long double " x ");"
  30 .sp
  31 .\"O Link with \fI\-lm\fP.
  32 \fI\-lm\fP でリンクする。
  33 .sp
  34 .in -4n
  35 .\"O Feature Test Macro Requirements for glibc (see
  36 .\"O .BR feature_test_macros (7)):
  37 glibc 向けの機能検査マクロの要件
  38 .RB ( feature_test_macros (7)
  39 参照):
  40 .in
  41 .sp
  42 .ad l
  43 .BR gamma ():
  44 .RS 4
  45 _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE
  46 .RE
  47 .BR gammaf (),
  48 .BR gammal ():
  49 .RS 4
  50 _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600
  51 .\" Also seems to work: -std=c99 -D_XOPEN_SOURCE
  52 .RE
  53 .ad b
  54 .\"O .SH DESCRIPTION
  55 .SH 説明
  56 .\"O These functions are deprecated: instead, use either the
  57 .\"O .BR tgamma (3)
  58 .\"O or the
  59 .\"O .BR lgamma (3)
  60 .\"O functions, as appropriate.
  61 これらの関数は非推奨である。その代わり、場面に応じて
  62 .BR tgamma (3)
  63 か
  64 .BR lgamma (3)
  65 を使うこと。
  66
  67 .\"O For the definition of the Gamma function, see
  68 .\"O .BR tgamma (3).
  69 ガンマ関数の定義については、
  70 .BR tgamma (3)
  71 を参照のこと。
  72 .\"O .SS "*BSD version"
  73 .SS *BSD版
  74 .\"O The libm in 4.4BSD and some versions of FreeBSD had a
  75 .\"O .BR gamma ()
  76 .\"O function that computes the Gamma function, as one would expect.
  77 4.4BSD の libm と FreeBSD のいくつかのバージョンには、関数
  78 .BR gamma ()
  79 が含まれており、期待通りガンマ関数を計算できる。
  80 .\"O .SS "glibc version"
  81 .SS glibc版
  82 .\"O Glibc has a
  83 .\"O .BR gamma ()
  84 .\"O function that is equivalent to
  85 .\"O .BR lgamma (3)
  86 .\"O and computes the natural logarithm of the Gamma function.
  87 Glibcは、関数
  88 .BR gamma ()
  89 を含んでいるが、これは
  90 .BR lgamma (3)
  91 と等価であり、ガンマ関数の自然対数を計算する。
  92 .\"O .SH RETURN VALUE
  93 .SH 返り値
  94 .\"O See
  95 .\"O .BR lgamma (3).
  96 .BR lgamma (3)
  97 を参照。
  98 .\"O .SH ERRORS
  99 .SH エラー
 100 .\"O See
 101 .\"O .BR lgamma (3).
 102 .BR lgamma (3)
 103 を参照。
 104 .\"O .SH "CONFORMING TO"
 105 .SH 準拠
 106 .\"O Because of historical variations in behavior across systems,
 107 .\"O this function is not specified in any standard.
 108 システムによって振舞いが異なるという歴史的な経緯のため、
 109 この関数はどの標準規格でも規定されていない。
 110 .\"O .SH NOTES
 111 .SH 注意
 112 .\"O .SS History
 113 .SS 歴史
 114 .\"O 4.2BSD had a
 115 .\"O .BR gamma ()
 116 .\"O that computed
 117 .\"O .RI ln(|Gamma(| x |)|),
 118 .\"O leaving the sign of
 119 .\"O .RI Gamma(| x |)
 120 .\"O in the external integer
 121 .\"O .IR signgam .
 122 4.2BSDにおいては、関数
 123 .BR gamma ()
 124 が実際に計算するのは
 125 .RI ln(|Gamma(| x |)|)
 126 であり、
 127 .RI Gamma(| x |)
 128 の符号が extern int \fIsigngam\fP に格納されていた。
 129 .\"O In 4.3BSD the name was changed to
 130 .\"O .BR lgamma (3),
 131 .\"O and the man page promises
 132 .\"O .sp
 133 .\"O .in +4n
 134 .\"O "At some time in the future the name gamma will be rehabilitated
 135 .\"O and used for the Gamma function"
 136 .\"O .in
 137 .\"O .sp
 138 4.3BSDになって関数名が変更され、
 139 .BR lgamma (3)
 140 となり、そのマニュアルページでは
 141 .sp
 142 .in +4n
 143 「いつの日か gamma の名は復活し、ガンマ関数に冠されるであろう」
 144 .in
 145 .sp
 146 という誓いが述べられていた。
 147 .\"O This did indeed happen in 4.4BSD, where
 148 .\"O .BR gamma ()
 149 .\"O computes the Gamma function (with no effect on
 150 .\"O .IR signgam ).
 151 .\"O However, this came too late, and we now have
 152 .\"O .BR tgamma (3),
 153 .\"O the "true gamma" function.
 154 .\" The FreeBSD man page says about gamma() that it is like lgamma()
 155 .\" except that is does not set signgam.
 156 .\" Also, that 4.4BSD has a gamma() that computes the true gamma function.
 157 これは4.4BSDになって実現され、
 158 .BR gamma ()
 159 はまさにガンマ関数を計算するようになった。
 160 (もう \fIsigngam\fP には作用しない。)
 161 ところが、これが登場する時期が遅すぎたため、
 162 .BR tgamma (3)
 163 という「本当のガンマ関数」がすでに存在しているのである。
 164 .\" FreeBSDのマニュアルによれば、gamma()はsigngamをセットしない
 165 .\" ことを除けばlgamma()と同様だという。
 166 .\" また、4.4BSDではgamma()は本当のガンマ関数を計算するともいう。
 167 .\"O .SH "SEE ALSO"
 168 .\"O .BR lgamma (3),
 169 .\"O .BR signgam (3),
 170 .\"O .BR tgamma (3)
 171 .SH 関連項目
 172 .BR lgamma (3),
 173 .BR signgam (3),
 174 .BR tgamma (3)