sqrt, sqrtf, sqrtl
提供: cppreference.com
| ヘッダ <math.h> で定義
|
||
| float sqrtf( float arg ); |
(1) | (C99以上) |
| double sqrt( double arg ); |
(2) | |
| long double sqrtl( long double arg ); |
(3) | (C99以上) |
| ヘッダ <tgmath.h> で定義
|
||
| #define sqrt( arg ) |
(4) | (C99以上) |
1-3)
arg の平方根を計算します。4) 型総称マクロ。
arg が long double の場合は sqrtl が呼ばれます。 そうでなく、 arg が整数型または double 型の場合は sqrt が呼ばれます。 そうでなければ sqrtf が呼ばれます。 arg が複素数または虚数の場合、マクロは対応する複素数の関数 (csqrtf, csqrt, csqrtl) を呼びます。目次 |
[編集] 引数
| arg | - | 浮動小数点値 |
[編集] 戻り値
エラーが発生なければ、 arg の平方根 (√arg) が返されます。
定義域エラーが発生した場合、処理系定義の値 (サポートされていれば NaN) が返されます。
アンダーフローによる値域エラーが発生した場合、 (丸めた後の) 正しい結果が返されます。
[編集] エラー処理
math_errhandling で規定されている通りにエラーが報告されます。
arg がゼロより小さい場合、定義域エラーが発生します。
処理系が IEEE 浮動小数点算術 (IEC 60559) をサポートしている場合、
- 引数が -0 より小さければ、 FE_INVALID が発生し、 NaN が返されます。
- 引数が +∞ または ±0 であれば、それが変更されずに返されます。
- 引数が NaN であれば、 NaN が返されます。
[編集] ノート
sqrt は IEEE 標準によって正確であることが要求されています。 他に正確であることが要求されている演算は、算術演算子と関数 fma だけです。 戻り値型に (デフォルトの丸めモードを使用して) 丸めた後、 sqrt の結果は無限に正確な結果から区別できません。 別の言い方をすると、誤差は 0.5 ulp 未満です。 他の関数 (pow など) には、そのような制約はありません。
[編集] 例
Run this code
#include <stdio.h> #include <math.h> #include <errno.h> #include <fenv.h> #pragma STDC FENV_ACCESS ON int main(void) { // normal use printf("sqrt(100) = %f\n", sqrt(100)); printf("sqrt(2) = %f\n", sqrt(2)); printf("golden ratio = %f\n", (1+sqrt(5))/2); // special values printf("sqrt(-0) = %f\n", sqrt(-0.0)); // error handling errno = 0; feclearexcept(FE_ALL_EXCEPT); printf("sqrt(-1.0) = %f\n", sqrt(-1)); if(errno == EDOM) perror(" errno == EDOM"); if(fetestexcept(FE_INVALID)) puts(" FE_INVALID was raised"); }
出力例:
sqrt(100) = 10.000000
sqrt(2) = 1.414214
golden ratio = 1.618034
sqrt(-0) = -0.000000
sqrt(-1.0) = -nan
errno = EDOM: Numerical argument out of domain
FE_INVALID was raised[編集] 参考文献
- C11 standard (ISO/IEC 9899:2011):
- 7.12.7.5 The sqrt functions (p: 249)
- 7.25 Type-generic math <tgmath.h> (p: 373-375)
- F.10.4.5 The sqrt functions (p: 525)
- C99 standard (ISO/IEC 9899:1999):
- 7.12.7.5 The sqrt functions (p: 229-230)
- 7.22 Type-generic math <tgmath.h> (p: 335-337)
- F.9.4.5 The sqrt functions (p: 462)
- C89/C90 standard (ISO/IEC 9899:1990):
- 4.5.5.2 The sqrt function
[編集] 関連項目
| (C99)(C99) |
x の y 乗 (xy) を計算します (関数) |
| (C99)(C99)(C99) |
立方根 (3√x) を計算します (関数) |
| (C99)(C99)(C99) |
2つの値の二乗和の平方根 (√x2 +y2 ) を計算します (関数) |
| (C99)(C99)(C99) |
複素数の平方根を計算します (関数) |
| sqrt の C++リファレンス
| |
