hypot, hypotf, hypotl

この関数が計算する値は、長さ x と y の辺を持つ直角三角形の斜辺の長さ、または点 ( x, y ) から原点 ( 0 , 0 ) までの距離、または複素数 x+ i y の絶対値です。

パラメータ

戻り値

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

オーバーフローによる範囲エラーが発生した場合、 +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未満の精度を保証します（ 最終桁単位 ）: GNU , BSD .

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

POSIXは アンダーフローが発生するのは、両方の引数が非正規化数であり、かつ正しい結果も非正規化数である場合のみであると規定しています（これは単純な実装を禁止するものです）。

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

例

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    // 典型的な使用例
    printf("(1,1) cartesian is (%f,%f) polar\n", hypot(1,1), atan2(1, 1));
    // 特殊な値
    printf("hypot(NAN,INFINITY) = %f\n", hypot(NAN, INFINITY));
    // エラー処理
    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

参考文献

関連項目