std::hypot, std::hypotf, std::hypotl

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

この関数の3引数版によって計算される値は、原点 (0,0,0) から点 (x,y,z) までの距離です。

[編集] 引数

[編集] 戻り値

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

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

[編集] エラー処理

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

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

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

[編集] ノート

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

std::hypot(x, y) は std::abs(std::complex<double>(x,y)) と同等です。

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

[編集] 例

#include <iostream>
#include <cmath>
#include <cerrno>
#include <cfenv>
#include <cfloat>
#include <cstring>
 
#pragma STDC FENV_ACCESS ON
int main()
{
    // 一般的な使用方法
    std::cout << "(1,1) cartesian is (" << std::hypot(1,1)
              << ',' << std::atan2(1,1) << ") polar\n";
    // 特殊な値
    std::cout << "hypot(NAN,INFINITY) = " << std::hypot(NAN,INFINITY) << '\n';
    // エラー処理
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "hypot(DBL_MAX,DBL_MAX) = " << std::hypot(DBL_MAX,DBL_MAX) << '\n';
    if (errno == ERANGE)
        std::cout << "    errno = ERANGE " << std::strerror(errno) << '\n';
    if (fetestexcept(FE_OVERFLOW))
        std::cout << "    FE_OVERFLOW raised\n";
}

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

[編集] 関連項目