X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=release%2Fman3%2Fhypot.3;h=bae835cc98507b4dbcf06540a7259268e3490483;hb=bb92023e2caf6dc30bd3a8f07877ec870c853e23;hp=8af34dea6f28870dc640b166422a9c963419eec0;hpb=7e089fcc022461849bbc09437103cc337a88dd9c;p=linuxjm%2FLDP_man-pages.git diff --git a/release/man3/hypot.3 b/release/man3/hypot.3 index 8af34dea..bae835cc 100644 --- a/release/man3/hypot.3 +++ b/release/man3/hypot.3 @@ -1,5 +1,6 @@ .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" +.\" %%%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. @@ -19,6 +20,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 @@ -28,141 +30,91 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.\" Japanese Version Copyright (c) 1996 Kenji Kajiwara -.\" all rights reserved. -.\" Translated Mon Jul 15 18:20:00 JST 1996 -.\" by Kenji Kajiwara -.\" Proof Reading: Takashi Yoshino -.\" Updated & Modified Sun Jun 6 05:30:45 JST 2004 -.\" by Yuichi SATO -.\" Updated & Modified Sat Jan 15 02:32:55 JST 2005 by Yuichi SATO -.\" Updated 2008-09-18, Akihiro MOTOKI +.\"******************************************************************* .\" -.TH HYPOT 3 2010-09-20 "" "Linux Programmer's Manual" -.SH ̾Á° -hypot, hypotf, hypotl \- ¥æ¡¼¥¯¥ê¥Ã¥Éµ÷Î¥´Ø¿ô -.SH ½ñ¼° +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH HYPOT 3 2010\-09\-20 "" "Linux Programmer's Manual" +.SH 名前 +hypot, hypotf, hypotl \- ユークリッド距離関数 +.SH 書式 .nf -.B #include +\fB#include \fP .sp -.BI "double hypot(double " x ", double " y ); +\fBdouble hypot(double \fP\fIx\fP\fB, double \fP\fIy\fP\fB);\fP .br -.BI "float hypotf(float " x ", float " y ); +\fBfloat hypotf(float \fP\fIx\fP\fB, float \fP\fIy\fP\fB);\fP .br -.BI "long double hypotl(long double " x ", long double " y ); +\fBlong double hypotl(long double \fP\fIx\fP\fB, long double \fP\fIy\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 hypot (): +\fBhypot\fP(): .RS 4 _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L; .br -or -.I cc\ -std=c99 +or \fIcc\ \-std=c99\fP .RE .br -.BR hypotf (), -.BR hypotl (): +\fBhypotf\fP(), \fBhypotl\fP(): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE +|| _POSIX_C_SOURCE\ >=\ 200112L; .br -or -.I cc\ -std=c99 +or \fIcc\ \-std=c99\fP .RE .ad b -.SH ÀâÌÀ -.BR hypot () -´Ø¿ô¤Ï -.RI sqrt( x * x + y * y ) -¤ÎÃͤòÊÖ¤¹¡£ -¤³¤ì¤Ï -ľ³Ñ¤ò¶´¤à 2 ÊÕ¤ÎŤµ¤¬ -.I x -¤È -.I y -¤Ç¤¢¤ëľ³Ñ»°³Ñ·Á¤Î¼ÐÊÕ¤ÎŤµ¡¢ -¤¹¤Ê¤ï¤Á¡¢¸¶ÅÀ¤ÈÅÀ -.RI ( x , y ) -¤È¤Îµ÷Î¥¤Ç¤¢¤ë¡£ +.SH 説明 +\fBhypot\fP() 関数は sqrt(\fIx\fP*\fIx\fP+\fIy\fP*\fIy\fP) の値を返す。 これは 直角を挟む 2 辺の長さが \fIx\fP と +\fIy\fP である直角三角形の斜辺の長さ、 すなわち、原点と点 (\fIx\fP,\fIy\fP) との距離である。 -·×»»¤ÎÃæ´Ö¥¹¥Æ¥Ã¥×¤Ç¤Ï¡¢É¬Íװʾå¤Î¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤ä¥¢¥ó¥À¡¼¥Õ¥í¡¼¤¬ -µ¯¤­¤Ê¤¤¤è¤¦¤Ë¤·¤Æ·×»»¤¬¼Â¹Ô¤µ¤ì¤ë¡£ .\" e.g., hypot(DBL_MIN, DBL_MIN) does the right thing, as does, say .\" hypot(DBL_MAX/2.0, DBL_MAX/2.0). -.SH ÊÖ¤êÃÍ -À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï¡¢ -ľ³Ñ¤ò¶´¤à 2 ÊÕ¤ÎŤµ¤¬ -.I x -¤È -.I y -¤Ç¤¢¤ëľ³Ñ»°³Ñ·Á¤Î¼ÐÊÕ¤ÎŤµ¤òÊÖ¤¹¡£ +計算の中間ステップでは、必要以上のオーバーフローやアンダーフローが 起きないようにして計算が実行される。 +.SH 返り値 +成功すると、これらの関数は、 直角を挟む 2 辺の長さが \fIx\fP と \fIy\fP である直角三角形の斜辺の長さを返す。 -.I x -¤« -.I y -¤¬Ìµ¸ÂÂç¤Î¾ì¹ç¡¢Àµ¤Î̵¸ÂÂ礬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP か \fIy\fP が無限大の場合、正の無限大が返される。 -.I x -¤« -.I y -¤Î°ìÊý¤¬ NaN ¤Ç¡¢¤â¤¦°ìÊý¤¬Ìµ¸ÂÂç¤Ç¤Ê¤¤¾ì¹ç¡¢ -NaN ¤¬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP か \fIy\fP の一方が NaN で、もう一方が無限大でない場合、 NaN が返される。 -·ë²Ì¤¬¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ÈÏ°Ï¥¨¥é¡¼ (range error) ¤¬È¯À¸¤·¡¢ -³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì -.BR HUGE_VAL , -.BR HUGE_VALF , -.B HUGE_VALL -¤òÊÖ¤¹¡£ +結果がオーバーフローする場合、範囲エラー (range error) が発生し、 各関数はそれぞれ \fBHUGE_VAL\fP, \fBHUGE_VALF\fP, +\fBHUGE_VALL\fP を返す。 -ξÊý¤Î°ú¤­¿ô¤¬ÈóÀµµ¬²½¿ô (subnormal) ¤Ç¡¢·ë²Ì¤âÈóÀµµ¬²½¿ô (subnormal) ¤Î¾ì¹ç¡¢ .\" Actually, could the result not be subnormal if both arguments .\" are subnormal? I think not -- mtk, Jul 2008 -ÈÏ°Ï¥¨¥é¡¼¤¬È¯À¸¤·¡¢Àµ¤·¤¤·ë²Ì¤¬ÊÖ¤µ¤ì¤ë¡£ -.SH ¥¨¥é¡¼ -¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¤«¤ÎȽÄêÊýË¡¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤Ï -.BR math_error (7) -¤ò»²¾È¤Î¤³¤È¡£ +両方の引き数が非正規化数 (subnormal) で、結果も非正規化数 (subnormal) の場合、 範囲エラーが発生し、正しい結果が返される。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 .PP -°Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ­¤¬¤¢¤ë¡£ -.TP -ÈÏ°Ï¥¨¥é¡¼: ·ë²Ì¤Î¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ -.I errno -¤Ë -.B ERANGE -¤¬ÀßÄꤵ¤ì¤ë¡£ -¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_OVERFLOW ) -¤¬¾å¤¬¤ë¡£ -.TP -ÈÏ°Ï¥¨¥é¡¼: ·ë²Ì¤Î¥¢¥ó¥À¡¼¥Õ¥í¡¼ +以下のエラーが発生する可能性がある。 +.TP +範囲エラー (range error): 結果のオーバーフロー +\fIerrno\fP に \fBERANGE\fP が設定される。 オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP) が上がる。 +.TP +範囲エラー (range error): 結果のアンダーフロー .\" .I errno .\" is set to .\" .BR ERANGE . -¥¢¥ó¥À¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_UNDERFLOW ) -¤¬¾å¤¬¤ë¡£ +アンダーフロー浮動小数点例外 (\fBFE_UNDERFLOW\fP) が上がる。 .IP -¤³¤Î¾ì¹ç¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï -.I errno -¤òÀßÄꤷ¤Ê¤¤¡£ .\" FIXME . Is it intentional that these functions do not set errno? .\" They do set errno for the overflow case. .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6795 -.SH ½àµò -C99, POSIX.1-2001. -.I double -ÈǤδؿô¤Ï SVr4, 4.3BSD ¤Ë¤â½àµò¤·¤Æ¤¤¤ë¡£ -.SH ´ØÏ¢¹àÌÜ -.BR cabs (3), -.BR sqrt (3) +これらの関数は、この場合に \fIerrno\fP を設定しない。 +.SH 準拠 +C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 +.SH 関連項目 +\fBcabs\fP(3), \fBsqrt\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。