std::acos, std::acosf, std::acosl
提供: cppreference.com
ヘッダ <cmath> で定義
|
||
(1) | ||
float acos ( float arg ); |
||
float acosf( float arg ); |
(C++11以上) | |
double acos ( double arg ); |
(2) | |
(3) | ||
long double acos ( long double arg ); |
||
long double acosl( long double arg ); |
(C++11以上) | |
double acos ( 整数型 arg ); |
(4) | (C++11以上) |
1-3)
arg
の逆余弦の主値を計算します。目次 |
[編集] 引数
arg | - | 浮動小数点または整数型の値 |
[編集] 戻り値
エラーが発生しなければ、範囲 [0 , π] 内の arg
の逆余弦 (arccos(arg)) が返されます。
定義域エラーが発生した場合、処理系定義の値 (サポートされていれば NaN) が返されます。
アンダーフローによる値域エラーが発生した場合、 (丸めた後の) 正しい結果が返されます。
[編集] エラー処理
math_errhandling で規定されている通りにエラーが報告されます。
arg
が範囲 [-1.0, 1.0]
外の場合、定義域エラーが発生します。
処理系が IEEE 浮動小数点算術 (IEC 60559) をサポートしている場合、
- 引数が +1 であれば、値
+0
が返されます。 - |arg| > 1 であれば、定義域エラーが発生し、 NaN が返されます。
- 引数が NaN であれば、 NaN が返されます。
[編集] 例
Run this code
#include <cmath> #include <iostream> #include <cerrno> #include <cfenv> #include <cstring> #pragma STDC FENV_ACCESS ON int main() { std::cout << "acos(-1) = " << acos(-1) << '\n' << "acos(0.0) = " << acos(0.0) << " 2*acos(0.0) = " << 2*acos(0) << '\n' << "acos(0.5) = " << acos(0.5) << " 3*acos(0.5) = " << 3*acos(0.5) << '\n' << "acos(1) = " << acos(1) << '\n'; // エラー処理 errno = 0; std::feclearexcept(FE_ALL_EXCEPT); std::cout << "acos(1.1) = " << acos(1.1) << '\n'; if (errno == EDOM) std::cout << " errno == EDOM: " << std::strerror(errno) << '\n'; if (std::fetestexcept(FE_INVALID)) std::cout << " FE_INVALID raised" << '\n'; }
出力:
acos(-1) = 3.14159 acos(0.0) = 1.5708 2*acos(0.0) = 3.14159 acos(0.5) = 1.0472 3*acos(0.5) = 3.14159 acos(1) = 0 acos(1.1) = nan errno == EDOM: Numerical argument out of domain FE_INVALID raised
[編集] 関連項目
(C++11)(C++11) |
逆正弦 (arcsin(x)) を計算します (関数) |
(C++11)(C++11) |
逆正接 (arctan(x)) を計算します (関数) |
(C++11)(C++11) |
象限を判断するために符号を使用して逆正接を計算します (関数) |
(C++11)(C++11) |
余弦 (cos(x)) を計算します (関数) |
(C++11) |
複素数の逆余弦 (arccos(z)) を計算します (関数テンプレート) |
valarray の各要素に関数 std::acos を適用します (関数テンプレート) | |
acos の C言語リファレンス
|