std:: sqrt, std:: sqrtf, std:: sqrtl

パラメータ

戻り値

エラーが発生しない場合、 num の平方根（ \({\small \sqrt{num} }\) √ num ）が返されます。

定義域エラーが発生した場合、実装定義の値が返されます（NaNがサポートされている場合はNaN）。

アンダーフローによる範囲エラーが発生した場合、正しい結果（丸め後）が返されます。

エラーハンドリング

エラーは math_errhandling で指定された通りに報告されます。

num がゼロ未満の場合、定義域エラーが発生します。

IEEE浮動小数点演算（IEC 60559）を実装がサポートしている場合、

• 引数が -0 より小さい場合、 FE_INVALID が発生し、NaN が返されます。
• 引数が +∞ または ±0 の場合、変更されずに返されます。
• 引数が NaN の場合、NaN が返されます。

注記

std::sqrt はIEEE標準により、無限精度の結果から正しく丸められることが要求されています。特に、浮動小数点型で表現可能な場合は正確な結果が生成されます。この要件が適用される他の演算は、 算術演算子 および関数 std::fma のみです。 std::pow を含む他の関数は、この制約を受けません。

追加のオーバーロードは (A) と完全に同一である必要はありません。それらは、整数型の引数 num に対して、 std :: sqrt ( num ) が std :: sqrt ( static_cast < double > ( num ) ) と同じ効果を持つことを保証するのに十分であればよいのです。

例

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    // 通常の使用
    std::cout << "sqrt(100) = " << std::sqrt(100) << '\n'
              << "sqrt(2) = " << std::sqrt(2) << '\n'
              << "golden ratio = " << (1 + std::sqrt(5)) / 2 << '\n';
    // 特殊な値
    std::cout << "sqrt(-0) = " << std::sqrt(-0.0) << '\n';
    // エラー処理
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "sqrt(-1.0) = " << std::sqrt(-1) << '\n';
    if (errno == EDOM)
        std::cout << "    errno = EDOM " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised\n";
}

sqrt(100) = 10
sqrt(2) = 1.41421
golden ratio = 1.61803
sqrt(-0) = -0
sqrt(-1.0) = -nan
    errno = EDOM Numerical argument out of domain
    FE_INVALID raised

関連項目