X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=release%2Fman3%2Fy0.3;h=32fb80cc23ca2bec584d2c7eb3aae2de2356adf0;hb=d6ffc03b1c10eddeb4564716656cf89586cce455;hp=650cbbaf408c0e75b60ff527aa4c0c1d33fbee0d;hpb=7e089fcc022461849bbc09437103cc337a88dd9c;p=linuxjm%2FLDP_man-pages.git diff --git a/release/man3/y0.3 b/release/man3/y0.3 index 650cbbaf..32fb80cc 100644 --- a/release/man3/y0.3 +++ b/release/man3/y0.3 @@ -2,6 +2,7 @@ .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk .\" .\" +.\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. @@ -21,6 +22,7 @@ .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END .\" .\" References consulted: .\" Linux libc source code @@ -31,205 +33,128 @@ .\" Modified 2004-11-12 as per suggestion by Fabian Kreutz/AEB .\" 2008-07-24, mtk, created this page, based on material from j0.3. .\" -.\" Japanese Version Copyright (c) 2008 Akihiro MOTOKI -.\" all rights reserved. -.\" Translated 2008-09-19, Akihiro MOTOKI , LDP v3.07 -.\" -.TH Y0 3 2008-08-10 "" "Linux Programmer's Manual" -.SH ̾Á° -y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl \- -ÂèÆó¼ï¥Ù¥Ã¥»¥ë´Ø¿ô -.SH ½ñ¼° +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH Y0 3 2008\-08\-10 "" "Linux Programmer's Manual" +.SH 名前 +y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl \- 第二種ベッセル関数 +.SH 書式 .nf -.B #include +\fB#include \fP .sp -.BI "double y0(double " x ); +\fBdouble y0(double \fP\fIx\fP\fB);\fP .br -.BI "double y1(double " x ); +\fBdouble y1(double \fP\fIx\fP\fB);\fP .br -.BI "double yn(int " n ", double " x ); +\fBdouble yn(int \fP\fIn\fP\fB, double \fP\fIx\fP\fB);\fP .sp -.BI "float y0f(float " x ); +\fBfloat y0f(float \fP\fIx\fP\fB);\fP .br -.BI "float y1f(float " x ); +\fBfloat y1f(float \fP\fIx\fP\fB);\fP .br -.BI "float ynf(int " n ", float " x ); +\fBfloat ynf(int \fP\fIn\fP\fB, float \fP\fIx\fP\fB);\fP .sp -.BI "long double y0l(long double " x ); +\fBlong double y0l(long double \fP\fIx\fP\fB);\fP .br -.BI "long double y1l(long double " x ); +\fBlong double y1l(long double \fP\fIx\fP\fB);\fP .br -.BI "long double ynl(int " n ", long double " x ); +\fBlong double ynl(int \fP\fIn\fP\fB, long double \fP\fIx\fP\fB);\fP .fi .sp -\fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£ +\fI\-lm\fP でリンクする。 .sp .in -4n -glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï -.RB ( feature_test_macros (7) -»²¾È): +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): .in .sp .ad l -.BR y0 (), -.BR y1 (), -.BR yn (): +\fBy0\fP(), \fBy1\fP(), \fByn\fP(): .RS 4 _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE .RE .br -.BR y0f (), -.BR y0l (), -.BR y1f (), -.BR y1l (), -.BR ynf (), -.BR ynl (): +\fBy0f\fP(), \fBy0l\fP(), \fBy1f\fP(), \fBy1l\fP(), \fBynf\fP(), \fBynl\fP(): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 600 .\" Also seems to work: -std=c99 -D_XOPEN_SOURCE +_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 600 .RE .ad b -.SH ÀâÌÀ +.SH 説明 .PP -´Ø¿ô -.BR y0 () -¤È -.BR y1 () -¤Ï¤½¤ì¤¾¤ì \fIx\fP ¤Î 0 ¼¡¡¢1 ¼¡¤Î -ÂèÆó¼ï¥Ù¥Ã¥»¥ë´Ø¿ô¤ÎÃͤòÊÖ¤¹¡£ -´Ø¿ô -.BR yn () -¤Ï \fIx\fP ¤Î \fIn\fP ¼¡¤Î -ÂèÆó¼ï¥Ù¥Ã¥»¥ë´Ø¿ô¤ÎÃͤòÊÖ¤¹¡£ +関数 \fBy0\fP() と \fBy1\fP() はそれぞれ \fIx\fP の 0 次、1 次の 第二種ベッセル関数の値を返す。 関数 \fByn\fP() は +\fIx\fP の \fIn\fP 次の 第二種ベッセル関数の値を返す。 .PP -\fIx\fP ¤ÏÀµ¤ÎÃͤǤʤ±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£ +\fIx\fP は正の値でなければならない。 .PP -.BR y0f () -·²¤Î´Ø¿ô¡¢ -.BR y0l () -·²¤Î´Ø¿ô¤Ï¡¢¤½¤ì¤¾¤ì -.I float -·¿¡¢ -.I "long double" -·¿¤ÎÊÖ¤êÃͤòÊÖ¤¹¡£ -.SH ÊÖ¤êÃÍ -À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï -.I x -¤ËÂФ¹¤ëÂèÆó¼ï¥Ù¥Ã¥»¥ë´Ø¿ô¤ÎÃͤòÊÖ¤¹¡£ +\fBy0f\fP() 群の関数、 \fBy0l\fP() 群の関数は、それぞれ \fIfloat\fP 型、 \fIlong double\fP 型の返り値を返す。 +.SH 返り値 +成功すると、これらの関数は \fIx\fP に対する第二種ベッセル関数の値を返す。 -.I x -¤¬ NaN ¤Î¾ì¹ç¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP が NaN の場合、NaN が返される。 -.I x -¤¬Éé¤Î¾ì¹ç¡¢Îΰ襨¥é¡¼ (domain error) ¤¬È¯À¸¤·¡¢ -³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì -.RB - HUGE_VAL , -.RB - HUGE_VALF , -.RB - HUGE_VALL -¤òÊÖ¤¹ (POSIX.1-2001 ¤Ç¤Ï¤³¤Î¾ì¹ç¤Ë NaN ¤òÊÖ¤¹¤³¤È¤âǧ¤á¤Æ¤¤¤ë)¡£ +\fIx\fP が負の場合、領域エラー (domain error) が発生し、 各関数はそれぞれ \-\fBHUGE_VAL\fP, \-\fBHUGE_VALF\fP, +\-\fBHUGE_VALL\fP を返す (POSIX.1\-2001 ではこの場合に NaN を返すことも認めている)。 -.I x -¤¬ 0.0 ¤Î¾ì¹ç¡¢¶Ë¥¨¥é¡¼ (pole error) ¤¬È¯À¸¤·¡¢ -³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì -.RB - HUGE_VAL , -.RB - HUGE_VALF , -.RB - HUGE_VALL -¤òÊÖ¤¹¡£ +\fIx\fP が 0.0 の場合、極エラー (pole error) が発生し、 各関数はそれぞれ \-\fBHUGE_VAL\fP, \-\fBHUGE_VALF\fP, +\-\fBHUGE_VALL\fP を返す。 -·ë²Ì¤¬¥¢¥ó¥À¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ -ÈÏ°Ï¥¨¥é¡¼ (range error) ¤¬È¯À¸¤·¡¢ -³Æ´Ø¿ô¤Ï 0.0 ¤òÊÖ¤¹¡£ +結果がアンダーフローする場合、 範囲エラー (range error) が発生し、 各関数は 0.0 を返す。 -·ë²Ì¤¬¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ÈÏ°Ï¥¨¥é¡¼¤¬È¯À¸¤·¡¢ -³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì -.RB - HUGE_VAL , -.RB - HUGE_VALF , -.RB - HUGE_VALL -¤òÊÖ¤¹ (POSIX.1-2001 ¤Ç¤Ï¤³¤Î¾ì¹ç¤Ë 0.0 ¤òÊÖ¤¹¤³¤È¤âǧ¤á¤Æ¤¤¤ë)¡£ -.SH ¥¨¥é¡¼ -¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¤«¤ÎȽÄêÊýË¡¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤Ï -.BR math_error (7) -¤ò»²¾È¤Î¤³¤È¡£ +結果がオーバーフローする場合、範囲エラーが発生し、 各関数はそれぞれ \-\fBHUGE_VAL\fP, \-\fBHUGE_VALF\fP, +\-\fBHUGE_VALL\fP を返す (POSIX.1\-2001 ではこの場合に 0.0 を返すことも認めている)。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 .PP -°Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ­¤¬¤¢¤ë¡£ -.TP -Îΰ襨¥é¡¼: \fIx\fP ¤¬Éé -.I errno -¤Ë -.B EDOM -¤¬ÀßÄꤵ¤ì¤ë¡£ -ÉÔÀµ (invalid) ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_INVALID ) -¤¬¾å¤¬¤ë¡£ -.TP -¶Ë¥¨¥é¡¼: \fIx\fP ¤¬ 0.0 +以下のエラーが発生する可能性がある。 +.TP +領域エラー (domain error): \fIx\fP が負である +\fIerrno\fP に \fBEDOM\fP が設定される。 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP) が上がる。 +.TP +極エラー: \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 -ÈÏ°Ï¥¨¥é¡¼: ·ë²Ì¤Î¥¢¥ó¥À¡¼¥Õ¥í¡¼ +\fIerrno\fP に \fBERANGE\fP が設定される (「バグ」の節を参照のこと)。 このエラーの場合、 \fBfetestexcept\fP(3) は +\fBFE_DIVBYZERO\fP 例外を返さない。 +.TP +範囲エラー (range error): 結果のアンダーフロー .\" 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 -ÈÏ°Ï¥¨¥é¡¼: ·ë²Ì¤Î¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ +\fIerrno\fP に \fBERANGE\fP が設定される。 このエラーの場合、 \fBfetestexcept\fP(3) は \fBFE_UNDERFLOW\fP +例外を返さない。 +.TP +範囲エラー (range error): 結果のオーバーフロー .\" 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 ½àµò -.I double -·¿¤ÎÃͤòÊÖ¤¹´Ø¿ô¤Ï¡¢SVr4, 4.3BSD, POSIX.1-2001 -¤Ë½àµò¤¹¤ë¡£ -¤½¤ì°Ê³°¤ÏÈóɸ½à¤Î´Ø¿ô¤Ç¡¢BSD ¤Ë¤â¸ºß¤¹¤ë¡£ -.SH ¥Ð¥° -¶Ë¥¨¥é¡¼¤Î¾ì¹ç¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï -.I errno -¤Ë -.B EDOM -¤òÀßÄꤹ¤ë¤¬¡¢ -POSIX.1-2004 ¤Ç¤Ï -.B ERANGE -¤òÀßÄꤹ¤ë¤³¤È¤¬Í׵ᤵ¤ì¤Æ¤¤¤ë¡£ +この場合、 \fIerrno\fP は設定されない。 オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP) が上がる。 +.SH 準拠 +\fIdouble\fP 型の値を返す関数は、SVr4, 4.3BSD, POSIX.1\-2001 に準拠する。 それ以外は非標準の関数で、BSD +にも存在する。 +.SH バグ .\" FIXME . .\" Bug raised: http://sourceware.org/bugzilla/show_bug.cgi?id=6807 +極エラーの場合、これらの関数は \fIerrno\fP に \fBEDOM\fP を設定するが、 POSIX.1\-2004 では \fBERANGE\fP +を設定することが要求されている。 -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 ´ØÏ¢¹àÌÜ -.BR j0 (3) +glibc バージョン 2.3.2 以前では、 領域エラーが発生した場合に、これらの関数は 不正浮動小数点例外 (\fBFE_INVALID\fP) +を上げない。 +.SH 関連項目 +\fBj0\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.51 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。