X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=draft%2Fman3%2Fscalb.3;h=94029726834f319354f5a360cb3038e84cada96e;hb=40274b7d79d419993de4a745e3ae86ca6d0f417f;hp=c62d0bbd139e6dc03796c3d68bde6476922ba41a;hpb=7e089fcc022461849bbc09437103cc337a88dd9c;p=linuxjm%2FLDP_man-pages.git diff --git a/draft/man3/scalb.3 b/draft/man3/scalb.3 index c62d0bbd..94029726 100644 --- a/draft/man3/scalb.3 +++ b/draft/man3/scalb.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,13 @@ .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* .\" .\" Japanese Version Copyright (c) 2005 Yuichi SATO all rights reserved. .\" and Copyright (c) 2008 Akihiro MOTOKI @@ -28,276 +36,101 @@ .\" by Yuichi SATO .\" Updated 2008-09-16, Akihiro MOTOKI .\" -.TH SCALB 3 2010-09-20 "" "Linux Programmer's Manual" -.\"O .SH NAME -.SH ̾Á° -.\"O scalb, scalbf, scalbl \- multiply floating-point number -.\"O by integral power of radix (OBSOLETE) -scalb, scalbf, scalbl \- ÉâÆ°¾®¿ôÅÀ¿ô¤ËÀ°¿ô¤Ç¤¢¤ë´ð¿ô¤ÎÎß¾è¤ò³Ý¤±¤ë (ÇÑ»ßͽÄê) -.\"O .SH SYNOPSIS -.SH ½ñ¼° -.B #include +.TH SCALB 3 2013\-03\-23 "" "Linux Programmer's Manual" +.SH 名前 +scalb, scalbf, scalbl \- 浮動小数点数に整数である基数の累乗を掛ける (廃止予定) +.SH 書式 +\fB#include \fP .sp -.BI "double scalb(double " x ", double " exp ); +\fBdouble scalb(double \fP\fIx\fP\fB, double \fP\fIexp\fP\fB);\fP .br -.BI "float scalbf(float " x ", double " exp ); +\fBfloat scalbf(float \fP\fIx\fP\fB, float \fP\fIexp\fP\fB);\fP .br -.BI "long double scalbl(long double " x ", double " exp ); +\fBlong double scalbl(long double \fP\fIx\fP\fB, long double \fP\fIexp\fP\fB);\fP .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 scalb (): +\fBscalb\fP(): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .RE .br -.BR scalbf (), -.BR scalbl (): +\fBscalbf\fP(), \fBscalbl\fP(): .RS 4 _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 .RE .ad b -.\"O .SH DESCRIPTION -.SH ÀâÌÀ -.\"O These functions multiply their first argument -.\"O .I x -.\"O by -.\"O .B FLT_RADIX -.\"O (probably 2) -.\"O to the power of -.\"O .IR exp , -.\"O that is: -¤³¤ì¤é¤Î´Ø¿ô¤ÏºÇ½é¤Î°ú¤­¿ô -.I x -¤Ë -.B FLT_RADIX -¤Î -.I exp -¾è¤ò³Ý¤±¤ë -.RB ( FLT_RADIX -¤Ï¤ª¤½¤é¤¯ 2 ¤Ç¤¢¤ë)¡£¤Ä¤Þ¤ê¡¢°Ê²¼¤Î¼°¤ÎÃͤòÊÖ¤¹¡£ +.SH 説明 +これらの関数は最初の引き数 \fIx\fP に \fBFLT_RADIX\fP の \fIexp\fP 乗を掛ける (\fBFLT_RADIX\fP はおそらく 2 +である)。つまり、以下の式の値を返す。 .nf x * FLT_RADIX ** exp .fi -.\"O The definition of -.\"O .B FLT_RADIX -.\"O can be obtained by including -.\"O .I . -.B FLT_RADIX -¤ÎÄêµÁ¤Ï -.I -¤ò¥¤¥ó¥¯¥ë¡¼¥É¤¹¤ë¤³¤È¤ÇÆÀ¤é¤ì¤ë¡£ -.\"O .\" not in /usr/include but in a gcc lib -.\" /usr/include ¤Ç¤Ï¤Ê¤¯¡¢gcc ¤Î lib ¤Ë¤¢¤ë¡£ -.\"O .SH RETURN VALUE -.SH ÊÖ¤êÃÍ -.\"O On success, these functions return \fIx\fP * \fBFLT_RADIX\fP ** \fIexp\fP. -À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï \fIx\fP * \fBFLT_RADIX\fP ** \fIexp\fP ¤òÊÖ¤¹¡£ +.\" not in /usr/include but in a gcc lib +\fBFLT_RADIX\fP の定義は \fI\fP をインクルードすることで得られる。 +.SH 返り値 +成功すると、これらの関数は \fIx\fP * \fBFLT_RADIX\fP ** \fIexp\fP を返す。 -.\"O If -.\"O .I x -.\"O or -.\"O .I exp -.\"O is a NaN, a NaN is returned. -.I x -¤« -.I exp -¤¬ NaN ¤Î¾ì¹ç¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP か \fIexp\fP が NaN の場合、NaN が返される。 -.\"O If -.\"O .I x -.\"O is positive infinity (negative infinity), -.\"O and -.\"O .I exp -.\"O is not negative infinity, -.\"O positive infinity (negative infinity) is returned. -.I x -¤¬Àµ¤Î̵¸ÂÂç (Éé¤Î̵¸ÂÂç) ¤Ç -.I exp -¤¬Éé¤Î̵¸ÂÂç¤Ç¤Ê¤¤¾ì¹ç¡¢Àµ¤Î̵¸ÂÂç (Éé¤Î̵¸ÂÂç) ¤¬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP が正の無限大 (負の無限大) で \fIexp\fP が負の無限大でない場合、正の無限大 (負の無限大) が返される。 -.\"O If -.\"O .I x -.\"O is +0 (\-0), and -.\"O .I exp -.\"O is not positive infinity, +0 (\-0) is returned. -.I x -¤¬ +0 (\-0) ¤Ç -.I exp -¤¬Àµ¤Î̵¸ÂÂç¤Ç¤Ê¤¤¾ì¹ç¡¢+0 (\-0) ¤¬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP が +0 (\-0) で \fIexp\fP が正の無限大でない場合、+0 (\-0) が返される。 -.\"O If -.\"O .I x -.\"O is zero, and -.\"O .I exp -.\"O is positive infinity, -.\"O a domain error occurs, and -.\"O a NaN is returned. -.I x -¤¬¥¼¥í¤Ç -.I exp -¤¬Àµ¤Î̵¸ÂÂç¤Î¾ì¹ç¡¢Îΰ襨¥é¡¼ (domain error) ¤¬È¯À¸¤·¡¢ -NaN ¤¬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP がゼロで \fIexp\fP が正の無限大の場合、領域エラー (domain error) が発生し、 NaN が返される。 -.\"O If -.\"O .I x -.\"O is an infinity, -.\"O and -.\"O .I exp -.\"O is negative infinity, -.\"O a domain error occurs, and -.\"O a NaN is returned. -.I x -¤¬Ìµ¸ÂÂç¤Ç -.I exp -¤¬Éé¤Î̵¸ÂÂç¤Î¾ì¹ç¡¢Îΰ襨¥é¡¼ (domain error) ¤¬È¯À¸¤·¡¢ -NaN ¤¬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP が無限大で \fIexp\fP が負の無限大の場合、領域エラー (domain error) が発生し、 NaN が返される。 -.\"O If the result overflows, -.\"O a range error occurs, -.\"O and the functions return -.\"O .BR HUGE_VAL , -.\"O .BR HUGE_VALF , -.\"O or -.\"O .BR HUGE_VALL , -.\"O respectively, with a sign the same as -.\"O .IR x . -·ë²Ì¤¬¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ -ÈÏ°Ï¥¨¥é¡¼ (range error) ¤¬È¯À¸¤·¡¢ -³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì -.BR HUGE_VAL , -.BR HUGE_VALF , -.BR HUGE_VALL -¤òÊÖ¤¹¡£Éä¹æ¤Ï -.I x -¤ÈƱ¤¸¤Ë¤Ê¤ë¡£ +結果がオーバーフローする場合、 範囲エラー (range error) が発生し、 各関数はそれぞれ \fBHUGE_VAL\fP, +\fBHUGE_VALF\fP, \fBHUGE_VALL\fP を返す。符号は \fIx\fP と同じになる。 -.\"O If the result underflows, -.\"O a range error occurs, -.\"O and the functions return zero, with a sign the same as -.\"O .IR x . -·ë²Ì¤¬¥¢¥ó¥À¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ÈÏ°Ï¥¨¥é¡¼¤¬È¯À¸¤·¡¢ -³Æ´Ø¿ô¤Ï 0 ¤òÊÖ¤¹¡£Éä¹æ¤Ï -.I x -¤ÈƱ¤¸¤Ë¤Ê¤ë¡£ -.\"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) -¤ò»²¾È¤Î¤³¤È¡£ +結果がアンダーフローする場合、範囲エラーが発生し、 各関数は 0 を返す。符号は \fIx\fP と同じになる。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 .PP -.\"O The following errors can occur: -°Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ­¤¬¤¢¤ë¡£ -.TP -.\"O Domain error: \fIx\fP is 0, and \fIexp\fP is positive infinity, \ -.\"O or \fIx\fP is positive infinity and \fIexp\fP is negative infinity \ -.\"O and the other argument is not a NaN -.\"Omotoki: °ú¤­¿ô¤Ï x, exp ¤ÎÆó¤Ä¤ÇξÊý¤È¤â¾ò·ï¤Ë´Þ¤Þ¤ì¤Æ¤¤¤ë¤Î¤Ç¡¢ -.\"Omotoki: ¾¤Î°ú¤­¿ô¤Ë´Ø¤¹¤ëµ­½Ò¤Ï°ÕÌ£¤¬¤Ê¤¤¤È»×¤ï¤ì¤ë¡£ÏÂÌõ¤Ç¤Ï¾Êά¤¹¤ë¡£ -Îΰ襨¥é¡¼ (domain error): \fIx\fP ¤¬ 0 ¤Ç \fIexp\fP ¤¬Àµ¤Î̵¸ÂÂç¡¢\ -¤Þ¤¿¤Ï \fIx\fP ¤¬Àµ¤Î̵¸ÂÂç¤Ç \fIexp\fP ¤¬Éé¤Î̵¸ÂÂç +以下のエラーが発生する可能性がある。 +.TP +領域エラー (domain error): \fIx\fP が 0 で \fIexp\fP が正の無限大、または \fIx\fP が正の無限大で \fIexp\fP が負の無限大 .\" .I errno .\" is set to .\" .BR EDOM . -.\"O An invalid floating-point exception -.\"O .RB ( FE_INVALID ) -.\"O is raised. -ÉÔÀµ (invalid) ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_INVALID ) -¤¬¾å¤¬¤ë¡£ -.TP -.\"O Range error, overflow -ÈÏ°Ï¥¨¥é¡¼ (range error)¡¢¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ +不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP) が上がる。 +.TP +範囲エラー (range error)、オーバーフローの場合 .\" .I errno .\" is set to .\" .BR ERANGE . -.\"O An overflow floating-point exception -.\"O .RB ( FE_OVERFLOW ) -.\"O is raised. -¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_OVERFLOW ) -¤¬¾å¤¬¤ë¡£ -.TP -.\"O Range error, underflow -ÈÏ°Ï¥¨¥é¡¼ (range error)¡¢¥¢¥ó¥À¡¼¥Õ¥í¡¼ +オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP) が上がる。 +.TP +範囲エラー (range error)、アンダーフローの場合 .\" .I errno .\" is set to .\" .BR ERANGE . -.\"O An underflow floating-point exception -.\"O .RB ( FE_UNDERFLOW ) -.\"O is raised. -¥¢¥ó¥À¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_UNDERFLOW ) -¤¬¾å¤¬¤ë¡£ +アンダーフロー浮動小数点例外 (\fBFE_UNDERFLOW\fP) が上がる。 .PP -.\"O These functions do not set -.\"O .IR errno . -¤³¤ì¤é¤Î´Ø¿ô¤Ï -.I errno -¤òÀßÄꤷ¤Ê¤¤¡£ .\" FIXME . Is it intentional that these functions do not set errno? .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803 .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6804 -.\"O .SH "CONFORMING TO" -.SH ½àµò -.\"O .BR scalb () -.\"O is specified in POSIX.1-2001, but marked obsolescent. -.\"O POSIX.1-2008 removes the specification of -.\"O .BR scalb (), -.\"O recommending the use of -.\"O .BR scalbln (3), -.\"O .BR scalblnf (3), -.\"O or -.\"O .BR scalblnl (3) -.\"O instead. -.\"O The -.\"O .BR scalb () -.\"O function is from 4.3BSD. -.BR scalb () -¤Ï POSIX.1-2001 ¤Çµ¬Äꤵ¤ì¤Æ¤¤¤ë¤¬¡¢ÇÑ»ßͽÄê¤È¤µ¤ì¤Æ¤¤¤ë¡£ -POSIX.1-2008 ¤Ç¤Ï -.BR scalb () -¤Î»ÅÍͤϺï½ü¤µ¤ì¤Æ¤ª¤ê¡¢Âå¤ï¤ê¤Ë -.BR scalbln (3), -.BR scalblnf (3), -.BR scalblnl (3) -¤Î»ÈÍѤ¬¿ä¾©¤µ¤ì¤Æ¤¤¤ë¡£ -.BR scalb () -´Ø¿ô¤Ï 4.3BSD ¤ËͳÍ褹¤ë¡£ +これらの関数は \fIerrno\fP を設定しない。 +.SH 準拠 +\fBscalb\fP() は POSIX.1\-2001 で規定されているが、廃止予定とされている。 POSIX.1\-2008 では \fBscalb\fP() +の仕様は削除されており、代わりに \fBscalbln\fP(3), \fBscalblnf\fP(3), \fBscalblnl\fP(3) の使用が推奨されている。 +\fBscalb\fP() 関数は 4.3BSD に由来する。 -.\"O .BR scalbf () -.\"O and -.\"O .BR scalbl () -.\"O are unstandardized; -.\"O .BR scalbf () -.\"O is nevertheless present on several other systems -.BR scalbf () -¤È -.BR scalbl () -¤Ïɸ½à²½¤µ¤ì¤Æ¤¤¤Ê¤¤¡£ -¤½¤ì¤Ë¤â´Ø¤ï¤é¤º¡¢ -.BR scalbf () -¤Ï¤¤¤¯¤Ä¤«¤Î¾¤Î¥·¥¹¥Æ¥à¤Ë¸ºß¤¹¤ë¡£ .\" Looking at header files: scalbf() is present on the .\" BSDs, Tru64, HP-UX 11, Irix 6.5; scalbl() is on HP-UX 11 and Tru64. -.\"O .SH "SEE ALSO" -.SH ´ØÏ¢¹àÌÜ -.BR ldexp (3), -.BR scalbln (3) +\fBscalbf\fP() と \fBscalbl\fP() は標準化されていない。 それにも関わらず、 \fBscalbf\fP() +はいくつかの他のシステムに存在する。 +.SH 関連項目 +\fBldexp\fP(3), \fBscalbln\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。