.\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
-.\" Distributed under GPL
-.\" based on glibc infopages
.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
.\" <mtk.manpages@gmail.com>
.\"
-.\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI
-.\" all rights reserved.
-.\" Translated Sun Sep 22 08:44:32 2002
-.\" by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated & Modified Sat Feb 12 12:40:00 2005
-.\" by SAITOH Akira <s-akira@users.sourceforge.net>
-.\" Updated 2008-09-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
+.\" Distributed under GPL
+.\" %%%LICENSE_END
+.\"
+.\" based on glibc infopages
+.\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH LGAMMA 3 2008-08-05 "" "Linux Programmer's Manual"
-.\"O .SH NAME
-.\"O lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam \-
-.\"O log gamma function
-.SH ̾Á°
+.\"*******************************************************************
+.TH LGAMMA 3 2010\-09\-11 "" "Linux Programmer's Manual"
+.SH 名前
lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam \-
-¥¬¥ó¥Þ´Ø¿ô¤ÎÂпô¤ò·×»»¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+ガンマ関数の対数を計算する
+.SH 書式
.nf
-.B #include <math.h>
+\fB#include <math.h>\fP
.sp
-.BI "double lgamma(double " x );
+\fBdouble lgamma(double \fP\fIx\fP\fB);\fP
.br
-.BI "float lgammaf(float " x );
+\fBfloat lgammaf(float \fP\fIx\fP\fB);\fP
.br
-.BI "long double lgammal(long double " x );
+\fBlong double lgammal(long double \fP\fIx\fP\fB);\fP
.sp
-.BI "double lgamma_r(double " x ", int *" signp );
+\fBdouble lgamma_r(double \fP\fIx\fP\fB, int *\fP\fIsignp\fP\fB);\fP
.br
-.BI "float lgammaf_r(float " x ", int *" signp );
+\fBfloat lgammaf_r(float \fP\fIx\fP\fB, int *\fP\fIsignp\fP\fB);\fP
.br
-.BI "long double lgammal_r(long double " x ", int *" signp );
+\fBlong double lgammal_r(long double \fP\fIx\fP\fB, int *\fP\fIsignp\fP\fB);\fP
.sp
-.BI "extern int " signgam ;
+\fBextern int \fP\fIsigngam\fP\fB;\fP
.fi
.sp
-.\"O Link with \fI\-lm\fP.
-\fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
+\fI\-lm\fP でリンクする。
.sp
.in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
.ad l
-.BR lgamma ():
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE; or
-.I cc\ -std=c99
+\fBlgamma\fP():
+.RS 4
+_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE ||
+_POSIX_C_SOURCE\ >=\ 200112L;
.br
-.BR lgammaf (),
-.BR lgammal ():
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or
-.I cc\ -std=c99
+or \fIcc\ \-std=c99\fP
+.RE
.br
-.BR lgamma_r (),
-.BR lgammaf_r (),
-.BR lgammal_r ():
-_BSD_SOURCE || _SVID_SOURCE
+\fBlgammaf\fP(), \fBlgammal\fP():
+.RS 4
+_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE
+|| _POSIX_C_SOURCE\ >=\ 200112L;
.br
-.IR signgam :
+or \fIcc\ \-std=c99\fP
+.RE
+\fBlgamma_r\fP(), \fBlgammaf_r\fP(), \fBlgammal_r\fP():
+.RS 4
+_BSD_SOURCE || _SVID_SOURCE
+.RE
+\fIsigngam\fP:
+.RS 4
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE
+.RE
.ad b
-.\"O .SH DESCRIPTION
-.\"O For the definition of the Gamma function, see
-.\"O .BR tgamma (3).
-.\"O .PP
-.SH ÀâÌÀ
-¥¬¥ó¥Þ´Ø¿ô¤ÎÄêµÁ¤Ë¤Ä¤¤¤Æ¤Ï¡¢
-.BR tgamma (3)
-¤ò»²¾È¤Î¤³¤È¡£
+.SH 説明
+ガンマ関数の定義については、 \fBtgamma\fP(3) を参照のこと。
.PP
-.\"O The
-.\"O .BR lgamma ()
-.\"O function returns the natural logarithm of
-.\"O the absolute value of the Gamma function.
-.\"O The sign of the Gamma function is returned in the
-.\"O external integer \fIsigngam\fP declared in
-.\"O .IR <math.h> .
-.\"O It is 1 when the Gamma function is positive or zero, \-1
-.\"O when it is negative.
-.\"O .PP
-´Ø¿ô
-.BR lgamma ()
-¤Ï¡¢¥¬¥ó¥Þ´Ø¿ô¤ÎÀäÂÐÃͤμ«Á³Âпô¤òÊÖ¤¹¡£
-¥¬¥ó¥Þ´Ø¿ô¤ÎÉä¹æ¤Ï¡¢
-.I <math.h>
-¤ÇÀë¸À¤µ¤ì¤Æ¤¤¤ë extern int \fIsigngam\fP ¤Ë³ÊǼ¤µ¤ì¤ë¡£
-³ÊǼ¤µ¤ì¤ëÃͤϡ¢¥¬¥ó¥Þ´Ø¿ô¤¬Àµ¤Þ¤¿¤Ï 0 ¤Î¾ì¹ç 1¡¢
-Éé¤Î¾ì¹ç \-1 ¤Ç¤¢¤ë¡£
+関数 \fBlgamma\fP() は、ガンマ関数の絶対値の自然対数を返す。 ガンマ関数の符号は、 \fI<math.h>\fP で宣言されている
+extern int \fIsigngam\fP に格納される。 格納される値は、ガンマ関数が正または 0 の場合 1、 負の場合 \-1 である。
.PP
-.\"O Since using a constant location
-.\"O .I signgam
-.\"O is not thread-safe, the functions
-.\"O .BR lgamma_r ()
-.\"O etc. have
-.\"O been introduced; they return the sign via the argument
-.\"O .IR signp .
-.I signgam
-¤È¤¤¤¦¸ÇÄꤵ¤ì¤¿¾ì½ê¤ò»È¤¦¤³¤È¤Ï¥¹¥ì¥Ã¥É¥»¡¼¥Õ¤Ç¤Ï¤Ê¤¤¤Î¤Ç¡¢
-´Ø¿ô
-.BR lgamma_r ()
-¤Ê¤É¤¬Æ³Æþ¤µ¤ì¤Æ¤¤¤ë¡£
-¤³¤ì¤é¤Î´Ø¿ô¤Ç¤Ï¡¢Éä¹æ¤Ï°ú¤¿ô
-.I signp
-·Ðͳ¤ÇÊÖ¤µ¤ì¤ë¡£
-.\"O .SH RETURN VALUE
-.SH ÊÖ¤êÃÍ
-.\"O On success, these functions return the natural logarithm of Gamma(x).
-À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï Gamma(x) ¤Î¼«Á³Âпô¤òÊÖ¤¹¡£
+\fIsigngam\fP という固定された場所を使うことはスレッドセーフではないので、 関数 \fBlgamma_r\fP() などが導入されている。
+これらの関数では、符号は引き数 \fIsignp\fP 経由で返される。
+.SH 返り値
+成功すると、これらの関数は Gamma(x) の自然対数を返す。
-.\"O If
-.\"O .I x
-.\"O is a NaN, a NaN is returned.
-.I x
-¤¬ NaN ¤Î¾ì¹ç¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
+\fIx\fP が NaN の場合、NaN が返される。
-.\"O If
-.\"O .I x
-.\"O is 1 or 2, +0 is returned.
-.I x
-¤¬ 1 ¤« 2 ¤Î¾ì¹ç¡¢+0 ¤¬ÊÖ¤µ¤ì¤ë¡£
+\fIx\fP が 1 か 2 の場合、+0 が返される。
-.\"O If
-.\"O .I x
-.\"O is positive infinity or negative infinity,
-.\"O positive infinity is returned.
-.I x
-¤¬Àµ¤Î̵¸ÂÂ礫Éé¤Î̵¸ÂÂç¤Î¾ì¹ç¡¢
-Àµ¤Î̵¸ÂÂ礬ÊÖ¤µ¤ì¤ë¡£
+\fIx\fP が正の無限大か負の無限大の場合、正の無限大が返される。
-.\"O If
-.\"O .I x
-.\"O is a nonpositive integer,
-.\"O a pole error occurs,
-.\"O and the functions return
-.\"O .RB + HUGE_VAL ,
-.\"O .RB + HUGE_VALF ,
-.\"O or
-.\"O .RB + HUGE_VALL ,
-.\"O respectively.
-.I x
-¤¬Àµ¤Ç¤Ê¤¤À°¿ô¤Î¾ì¹ç¡¢¶Ë¥¨¥é¡¼ (pole error) ¤¬È¯À¸¤·¡¢
-³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì
-.RB + HUGE_VAL ,
-.RB + HUGE_VALF ,
-.RB + HUGE_VALL
-¤òÊÖ¤¹¡£
+\fIx\fP が正でない整数の場合、極エラー (pole error) が発生し、 各関数はそれぞれ +\fBHUGE_VAL\fP,
++\fBHUGE_VALF\fP, +\fBHUGE_VALL\fP を返す。
-.\"O If the result overflows,
-.\"O a range error occurs,
.\" e.g., lgamma(DBL_MAX)
-.\"O and the functions return
-.\"O .BR HUGE_VAL ,
-.\"O .BR HUGE_VALF ,
-.\"O or
-.\"O .BR HUGE_VALL ,
-.\"O respectively, with the correct mathematical sign.
-·ë²Ì¤¬¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ÈÏ°Ï¥¨¥é¡¼¤¬È¯À¸¤·¡¢
-³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì
-.BR HUGE_VAL ,
-.BR HUGE_VALF ,
-.B HUGE_VALL
-¤òÊÖ¤¹¡£ÊÖ¤êÃͤˤϿô³ØŪ¤ËÀµ¤·¤¤Éä¹æ¤¬ÉÕÍ¿¤µ¤ì¤ë¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.\"O See
-.\"O .BR math_error (7)
-.\"O for information on how to determine whether an error has occurred
-.\"O when calling these functions.
-¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¤«¤ÎȽÄêÊýË¡¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤Ï
-.BR math_error (7)
-¤ò»²¾È¤Î¤³¤È¡£
+結果がオーバーフローする場合、範囲エラー (range error) が発生し、 各関数はそれぞれ \fBHUGE_VAL\fP, \fBHUGE_VALF\fP,
+\fBHUGE_VALL\fP, を返す。この際、数学的に正しい符号が付与される。
+.SH エラー
+これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。
.PP
-.\"O The following errors can occur:
-°Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ¤¬¤¢¤ë¡£
-.TP
-.\"O Pole error: \fIx\fP is a nonpositive integer
-¶Ë¥¨¥é¡¼: \fIx\fP ¤¬Àµ¤Ç¤Ê¤¤À°¿ô
-.\"O .I errno
-.\"O is set to
-.\" FIXME . glibc 2.8 gives EDOM!
-.\"O .BR ERANGE
-.\"O (but see BUGS).
-.\"O A divide-by-zero floating-point exception
-.\"O .RB ( FE_DIVBYZERO )
-.\"O is raised.
-.I errno
-¤Ë
-.B ERANGE
-¤¬ÀßÄꤵ¤ì¤ë (¡Ö¥Ð¥°¡×¤ÎÀá¤ò»²¾È)¡£
-0 ¤Ë¤è¤ë½ü»» (divide-by-zero) ÉâÆ°¾®¿ôÅÀÎã³°
-.RB ( FE_DIVBYZERO )
-¤¬¾å¤¬¤ë¡£
-.TP
-.\"O Range error: result overflow
-ÈÏ°Ï¥¨¥é¡¼: ·ë²Ì¤Î¥ª¡¼¥Ð¡¼¥Õ¥í¡¼
-.\"O .I errno
-.\"O is set to
-.\"O .BR ERANGE .
-.\"O An overflow floating-point exception
-.\"O .RB ( FE_OVERFLOW )
-.\"O is raised.
-.I errno
-¤Ë
-.B ERANGE
-¤¬ÀßÄꤵ¤ì¤ë¡£
-¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³°
-.RB ( FE_OVERFLOW )
-¤¬¾å¤¬¤ë¡£
+以下のエラーが発生する可能性がある。
+.TP
+極エラー: \fIx\fP が正でない整数
+\fIerrno\fP に \fBERANGE\fP が設定される (「バグ」の節も参照)。 0 による除算 (divide\-by\-zero) 浮動小数点例外
+(\fBFE_DIVBYZERO\fP) が上がる。
+.TP
+範囲エラー (range error): 結果のオーバーフロー
.\" glibc (as at 2.8) also supports an inexact
.\" exception for various cases.
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-.\"O The
-.\"O .BR lgamma ()
-.\"O functions are specified in C99 and POSIX.1-2001.
-.\"O .I signgam
-.\"O is specified in POSIX.1-2001, but not in C99.
-.\"O The
-.\"O .BR lgamma_r ()
-.\"O functions are nonstandard, but present on several other systems.
-´Ø¿ô
-.BR lgamma ()
-¤Ï C99 ¤È POSIX.1-2001 ¤Çµ¬Äꤵ¤ì¤Æ¤¤¤ë¡£
-.I signgam
-¤Ï POSIX.1-2001 ¤Çµ¬Äꤵ¤ì¤Æ¤¤¤ë¤¬¡¢C99 ¤Ë¤Ï¤Ê¤¤¡£
-´Ø¿ô
-.BR lgamma_r ()
-¤ÏÈóɸ½à¤À¤¬¡¢¤¤¤¯¤Ä¤«¤Î¾¤Î¥·¥¹¥Æ¥à¤Ë¤â¸ºß¤¹¤ë¡£
-.\"O .SH BUGS
-.SH ¥Ð¥°
-.\"O For a pole error,
-¶Ë¥¨¥é¡¼¤Î¾ì¹ç¡¢
-.\"
-.\" FIXME . this is as at glibc 2.8; check later if this bug is fixed
-.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6777
-.\"O .I errno
-.\"O is set to
-.\"O .BR EDOM ;
-.I errno
-¤Ë
-.B EDOM
-¤¬ÀßÄꤵ¤ì¤ë¡£
-.\"O POSIX.1 says it should be set to
-.\"O .BR ERANGE .
-POSIX.1 ¤Ç¤Ï¡¢
-.B ERANGE
-¤¬ÀßÄꤵ¤ì¤ë¤Ù¤¤È¤µ¤ì¤Æ¤¤¤ë¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR tgamma (3)
+\fIerrno\fP に \fBERANGE\fP が設定される。 オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP) が上がる。
+.SH 準拠
+関数 \fBlgamma\fP() は C99 と POSIX.1\-2001 で規定されている。 \fIsigngam\fP は POSIX.1\-2001
+で規定されているが、C99 にはない。 関数 \fBlgamma_r\fP() は非標準だが、いくつかの他のシステムにも存在する。
+.SH バグ
+.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6777
+glibc 2.9 とそれ以前のバージョンでは、 極エラーが発生した場合、POSIX で要求されている \fBERANGE\fP ではなく \fBEDOM\fP が
+\fIerrno\fP に設定される。 POSIX.1 では、 \fBERANGE\fP が設定されるべきとされている。 バージョン 2.10 以降の glibc
+では、正しい動作をする。
+.SH 関連項目
+\fBtgamma\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
