.\" Translated 2008-09-19, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.07
.\"
.TH Y0 3 2008-08-10 "" "Linux Programmer's Manual"
-.SH ̾Á°
+.SH 名前
y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl \-
-ÂèÆó¼ï¥Ù¥Ã¥»¥ë´Ø¿ô
-.SH ½ñ¼°
+第二種ベッセル関数
+.SH 書式
.nf
.B #include <math.h>
.sp
.BI "long double ynl(int " n ", long double " x );
.fi
.sp
-\fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
+\fI\-lm\fP でリンクする。
.sp
.in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
+glibc 向けの機能検査マクロの要件
.RB ( feature_test_macros (7)
-»²¾È):
+参照):
.in
.sp
.ad l
.\" Also seems to work: -std=c99 -D_XOPEN_SOURCE
.RE
.ad b
-.SH ÀâÌÀ
+.SH 説明
.PP
-´Ø¿ô
+関数
.BR y0 ()
-¤È
+と
.BR y1 ()
-¤Ï¤½¤ì¤¾¤ì \fIx\fP ¤Î 0 ¼¡¡¢1 ¼¡¤Î
-ÂèÆó¼ï¥Ù¥Ã¥»¥ë´Ø¿ô¤ÎÃͤòÊÖ¤¹¡£
-´Ø¿ô
+はそれぞれ \fIx\fP の 0 次、1 次の
+第二種ベッセル関数の値を返す。
+関数
.BR yn ()
-¤Ï \fIx\fP ¤Î \fIn\fP ¼¡¤Î
-ÂèÆó¼ï¥Ù¥Ã¥»¥ë´Ø¿ô¤ÎÃͤòÊÖ¤¹¡£
+は \fIx\fP の \fIn\fP 次の
+第二種ベッセル関数の値を返す。
.PP
-\fIx\fP ¤ÏÀµ¤ÎÃͤǤʤ±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+\fIx\fP は正の値でなければならない。
.PP
.BR y0f ()
-·²¤Î´Ø¿ô¡¢
+群の関数、
.BR y0l ()
-·²¤Î´Ø¿ô¤Ï¡¢¤½¤ì¤¾¤ì
+群の関数は、それぞれ
.I float
-·¿¡¢
+型、
.I "long double"
-·¿¤ÎÊÖ¤êÃͤòÊÖ¤¹¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï
+型の返り値を返す。
+.SH 返り値
+成功すると、これらの関数は
.I x
-¤ËÂФ¹¤ëÂèÆó¼ï¥Ù¥Ã¥»¥ë´Ø¿ô¤ÎÃͤòÊÖ¤¹¡£
+に対する第二種ベッセル関数の値を返す。
.I x
-¤¬ NaN ¤Î¾ì¹ç¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
+が NaN の場合、NaN が返される。
.I x
-¤¬Éé¤Î¾ì¹ç¡¢Îΰ襨¥é¡¼ (domain error) ¤¬È¯À¸¤·¡¢
-³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì
+が負の場合、領域エラー (domain error) が発生し、
+各関数はそれぞれ
.RB - HUGE_VAL ,
.RB - HUGE_VALF ,
.RB - HUGE_VALL
-¤òÊÖ¤¹ (POSIX.1-2001 ¤Ç¤Ï¤³¤Î¾ì¹ç¤Ë NaN ¤òÊÖ¤¹¤³¤È¤âǧ¤á¤Æ¤¤¤ë)¡£
+を返す (POSIX.1-2001 ではこの場合に NaN を返すことも認めている)。
.I x
-¤¬ 0.0 ¤Î¾ì¹ç¡¢¶Ë¥¨¥é¡¼ (pole error) ¤¬È¯À¸¤·¡¢
-³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì
+が 0.0 の場合、極エラー (pole error) が発生し、
+各関数はそれぞれ
.RB - HUGE_VAL ,
.RB - HUGE_VALF ,
.RB - HUGE_VALL
-¤òÊÖ¤¹¡£
+を返す。
-·ë²Ì¤¬¥¢¥ó¥À¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢
-ÈÏ°Ï¥¨¥é¡¼ (range error) ¤¬È¯À¸¤·¡¢
-³Æ´Ø¿ô¤Ï 0.0 ¤òÊÖ¤¹¡£
+結果がアンダーフローする場合、
+範囲エラー (range error) が発生し、
+各関数は 0.0 を返す。
-·ë²Ì¤¬¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ÈÏ°Ï¥¨¥é¡¼¤¬È¯À¸¤·¡¢
-³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì
+結果がオーバーフローする場合、範囲エラーが発生し、
+各関数はそれぞれ
.RB - HUGE_VAL ,
.RB - HUGE_VALF ,
.RB - HUGE_VALL
-¤òÊÖ¤¹ (POSIX.1-2001 ¤Ç¤Ï¤³¤Î¾ì¹ç¤Ë 0.0 ¤òÊÖ¤¹¤³¤È¤âǧ¤á¤Æ¤¤¤ë)¡£
-.SH ¥¨¥é¡¼
-¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¤«¤ÎȽÄêÊýË¡¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤Ï
+を返す (POSIX.1-2001 ではこの場合に 0.0 を返すことも認めている)。
+.SH ã\82¨ã\83©ã\83¼
+これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は
.BR math_error (7)
-¤ò»²¾È¤Î¤³¤È¡£
+を参照のこと。
.PP
-°Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ¤¬¤¢¤ë¡£
+以下のエラーが発生する可能性がある。
.TP
-Îΰ襨¥é¡¼: \fIx\fP ¤¬Éé
+領域エラー: \fIx\fP が負
.I errno
-¤Ë
+に
.B EDOM
-¤¬ÀßÄꤵ¤ì¤ë¡£
-ÉÔÀµ (invalid) ÉâÆ°¾®¿ôÅÀÎã³°
+が設定される。
+不正 (invalid) 浮動小数点例外
.RB ( FE_INVALID )
-¤¬¾å¤¬¤ë¡£
+が上がる。
.TP
-¶Ë¥¨¥é¡¼: \fIx\fP ¤¬ 0.0
+極エラー: \fIx\fP が 0.0
.\" Before POSIX.1-2001 TC2, this was (inconsistently) specified
.\" as a range error.
.\" FIXME . y0(0.0) gives EDOM
.I errno
-¤Ë
+に
.B ERANGE
-¤¬ÀßÄꤵ¤ì¤ë (¡Ö¥Ð¥°¡×¤ÎÀá¤ò»²¾È¤Î¤³¤È)¡£
-¤³¤Î¥¨¥é¡¼¤Î¾ì¹ç¡¢
+が設定される (「バグ」の節を参照のこと)。
+このエラーの場合、
.BR fetestexcept (3)
-¤Ï
+は
.B FE_DIVBYZERO
-Îã³°¤òÊÖ¤µ¤Ê¤¤¡£
+例外を返さない。
.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808
.TP
-ÈÏ°Ï¥¨¥é¡¼: ·ë²Ì¤Î¥¢¥ó¥À¡¼¥Õ¥í¡¼
+ç¯\84å\9b²ã\82¨ã\83©ã\83¼: çµ\90æ\9e\9cã\81®ã\82¢ã\83³ã\83\80ã\83¼ã\83\95ã\83ã\83¼
.\" e.g., y0(1e33) on glibc 2.8/x86-32
.I errno
-¤Ë
+に
.B ERANGE
-¤¬ÀßÄꤵ¤ì¤ë¡£
+が設定される。
.\" An underflow floating-point exception
.\" .RB ( FE_UNDERFLOW )
.\" is raised.
.\" FIXME . Is it intentional that these functions do not use FE_*?
.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6806
-¤³¤Î¥¨¥é¡¼¤Î¾ì¹ç¡¢
+このエラーの場合、
.BR fetestexcept (3)
-¤Ï
+は
.B FE_UNDERFLOW
-Îã³°¤òÊÖ¤µ¤Ê¤¤¡£
+例外を返さない。
.TP
-ÈÏ°Ï¥¨¥é¡¼: ·ë²Ì¤Î¥ª¡¼¥Ð¡¼¥Õ¥í¡¼
+ç¯\84å\9b²ã\82¨ã\83©ã\83¼: çµ\90æ\9e\9cã\81®ã\82ªã\83¼ã\83\90ã\83¼ã\83\95ã\83ã\83¼
.\" e.g., yn(10, 1e-40) on glibc 2.8/x86-32
.\" .I errno
.\" is set to
.\" .BR ERANGE .
-¤³¤Î¾ì¹ç¡¢
+この場合、
.I errno
-¤ÏÀßÄꤵ¤ì¤Ê¤¤¡£
+は設定されない。
.\" FIXME . Is it intentional that errno is not set?
.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808
-¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³°
+オーバーフロー浮動小数点例外
.RB ( FE_OVERFLOW )
-¤¬¾å¤¬¤ë¡£
-.SH ½àµò
+が上がる。
+.SH 準拠
.I double
-·¿¤ÎÃͤòÊÖ¤¹´Ø¿ô¤Ï¡¢SVr4, 4.3BSD, POSIX.1-2001
-¤Ë½àµò¤¹¤ë¡£
-¤½¤ì°Ê³°¤ÏÈóɸ½à¤Î´Ø¿ô¤Ç¡¢BSD ¤Ë¤â¸ºß¤¹¤ë¡£
-.SH ¥Ð¥°
-¶Ë¥¨¥é¡¼¤Î¾ì¹ç¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï
+型の値を返す関数は、SVr4, 4.3BSD, POSIX.1-2001
+に準拠する。
+それ以外は非標準の関数で、BSD にも存在する。
+.SH ã\83\90ã\82°
+極エラーの場合、これらの関数は
.I errno
-¤Ë
+に
.B EDOM
-¤òÀßÄꤹ¤ë¤¬¡¢
-POSIX.1-2004 ¤Ç¤Ï
+を設定するが、
+POSIX.1-2004 では
.B ERANGE
-¤òÀßÄꤹ¤ë¤³¤È¤¬Í׵ᤵ¤ì¤Æ¤¤¤ë¡£
+を設定することが要求されている。
.\" FIXME .
.\" Bug raised: http://sourceware.org/bugzilla/show_bug.cgi?id=6807
-glibc ¥Ð¡¼¥¸¥ç¥ó 2.3.2 °ÊÁ°¤Ç¤Ï¡¢
+glibc バージョン 2.3.2 以前では、
.\" FIXME . Actually, 2.3.2 is the earliest test result I have; so yet
.\" to confirm if this error occurs only in 2.3.2.
-Îΰ襨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ë¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï
-ÉÔÀµÉâÆ°¾®¿ôÅÀÎã³°
+領域エラーが発生した場合に、これらの関数は
+不正浮動小数点例外
.RB ( FE_INVALID )
-¤ò¾å¤²¤Ê¤¤¡£
-.SH ´ØÏ¢¹àÌÜ
+を上げない。
+.SH 関連項目
.BR j0 (3)