cpp/numeric/math/sqrtのソースを表示

あなたには「このページの編集」を行う権限がありません。理由は以下の通りです:

この操作は、次のグループのいずれかに属する利用者のみが実行できます: 登録利用者、管理者。

このページのソースの閲覧やコピーができます。

{{cpp/title|sqrt|sqrtf|sqrtl}}
{{cpp/numeric/math/navbar}}
{{dcl begin}}
{{dcl header | cmath}}
{{dcl rev multi|num=1|
|until1=|dcl1=
float       sqrt ( float arg );
|since2=c++11|dcl2=
float       sqrtf( float arg );
}}
{{dcl |num=2|
double      sqrt ( double arg );
}}
{{dcl rev multi|num=3|
|until1=|dcl1=
long double sqrt ( long double arg );
|since2=c++11|dcl2=
long double sqrtl( long double arg );
}}
{{dcl |num=4| since=c++11 |
double      sqrt ( 整数型 arg );
}}
{{dcl end}}

@1-3@ {{tt|arg}} の平方根を計算します。
@4@ 任意の[[cpp/types/is_integral|整数型]]の引数を受理するオーバーロード集合または関数テンプレート。 2) と同等です (引数は {{c|double}} にキャストされます)。

===引数===
{{par begin}}
{{par | arg | 浮動小数点または[[cpp/types/is_integral|整数型]]の値}}
{{par end}}

===戻り値===
エラーが発生なければ、 {{tt|arg}} の平方根 ({{math|{{mrad|arg}}}}) が返されます。

定義域エラーが発生した場合、処理系定義の値 (サポートされていれば NaN) が返されます。

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

===エラー処理===
{{lc|math_errhandling}} で規定されている通りにエラーが報告されます。

{{tt|arg}} がゼロより小さい場合、定義域エラーが発生します。

処理系が IEEE 浮動小数点算術 (IEC 60559) をサポートしている場合、
* 引数が -0 より小さければ、 {{lc|FE_INVALID}} が発生し、 NaN が返されます。
* 引数が +∞ または ±0 であれば、それが変更されずに返されます。
* 引数が NaN であれば、 NaN が返されます。

===ノート===
{{tt|std::sqrt}} は IEEE 標準によって正確であることが要求されています。 他に正確であることが要求されている演算は、[[cpp/language/operator_arithmetic|算術演算子]]と関数 {{lc|std::fma}} だけです。 戻り値型に (デフォルトの丸めモードを使用して) 丸めた後、 {{tt|std::sqrt}} の結果は無限に正確な結果から区別できません。 別の言い方をすると、誤差は 0.5 ulp 未満です。 他の関数 ({{lc|std::pow}} など) には、そのような制約はありません。

===例===
{{example |
 | code=
#include <iostream>
#include <cmath>
#include <cerrno>
#include <cfenv>
#include <cstring>

#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";
}
 | p=true
 | output=
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
}}

===関連項目===
{{dsc begin}}
{{dsc inc | cpp/numeric/math/dsc pow}}
{{dsc inc | cpp/numeric/math/dsc cbrt}}
{{dsc inc | cpp/numeric/math/dsc hypot}}
{{dsc inc | cpp/numeric/complex/dsc sqrt}}
{{dsc inc | cpp/numeric/valarray/dsc sqrt}}
{{dsc see c | c/numeric/math/sqrt}}
{{dsc end}}

{{langlinks|de|en|es|fr|it|pl|pt|ru|zh}}

このページで使用されているテンプレート:

cppreference.com

検索

名前空間

変種

表示

操作

cpp/numeric/math/sqrtのソースを表示