OSDN Git Service

(split) DP: release pages (catch up to 3.50).
[linuxjm/LDP_man-pages.git] / release / man3 / hypot.3
index 8af34de..bae835c 100644 (file)
@@ -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
 .\" 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 <ysato444@yahoo.co.jp>
-.\" Updated & Modified Sat Jan 15 02:32:55 JST 2005 by Yuichi SATO
-.\" Updated 2008-09-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\"*******************************************************************
 .\"
-.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 <math.h>
+\fB#include <math.h>\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/ に書かれている。