hypot, hypotf, hypotl

この関数によって計算される値は、2辺の長さが x および y の直角三角形の斜辺の長さ、または原点 (0,0) から点 (x,y) までの距離、または複素数 x+iy の絶対値です。

[編集] 引数

[編集] 戻り値

エラーが発生しなければ、直角三角形の斜辺 \(\scriptsize{\sqrt{x^2+y^2} }\)√x2
+y2
が返されます。

オーバーフローによる値域エラーが発生した場合、 +HUGE_VAL、 +HUGE_VALF または +HUGE_VALL が返されます。

アンダーフローによる値域エラーが発生した場合、 (丸めの後の) 正しい結果が返されます。

[編集] エラー処理

math_errhandling で規定されている通りにエラーが報告されます。

処理系が IEEE 浮動小数点算術 (IEC 60559) をサポートしている場合、

• hypot(x, y)、 hypot(y, x)、 hypot(x, -y) は同等です。
• 引数のひとつが ±0 であれば、 hypot は他方の引数で fabs を呼ぶのと同等です。
• 引数のひとつが ±∞ であれば、他方の引数が NaN であっても、 hypot は +∞ を返します。
• そうでなく、いずれかの引数が NaN であれば、 NaN が返されます。

[編集] ノート

処理系は通常、 1 ulp (units in the last place) 未満の精度を保証します (GNU, BSD, Open64)。

hypot(x, y) は cabs (x + I*y) と同等です。

POSIX は、引数がどちらも非正規化数で、正しい結果も非正規化数である場合にのみ、アンダーフローが発生する可能性があると規定しています (これはナイーブな実装を禁止します)。

hypot(INFINITY, NAN) は +∞ を返しますが、 sqrt (INFINITY*INFINITY+NAN*NAN) は NaN を返します。

[編集] 例

#include <stdio.h>
#include <math.h>
#include <errno.h>
#include <fenv.h>
#include <float.h>
 
#pragma STDC FENV_ACCESS ON
int main(void)
{
 // typical usage
 printf ("(1,1) cartesian is (%f,%f) polar\n", hypot(1,1), atan2 (1,1));
 // special values
 printf ("hypot(NAN,INFINITY) = %f\n", hypot(NAN,INFINITY));
 // error handling 
 errno = 0; feclearexcept (FE_ALL_EXCEPT );
 printf ("hypot(DBL_MAX,DBL_MAX) = %f\n", hypot(DBL_MAX,DBL_MAX ));
 if(errno == ERANGE ) perror (" errno == ERANGE");
 if(fetestexcept (FE_OVERFLOW )) puts (" FE_OVERFLOW raised");
}

(1,1) cartesian is (1.414214,0.785398) polar
hypot(NAN,INFINITY) = inf
hypot(DBL_MAX,DBL_MAX) = inf
 errno == ERANGE: Numerical result out of range
 FE_OVERFLOW raised

[編集] 参考文献

• 他言語版

• العربية
• Česky
• Deutsch
• English
• Español
• Français
• Italiano
• 한국어
• Polski
• Português
• Русский
• Türkçe
• 中文