std::acosh, std::acoshf, std::acoshl
提供: cppreference.com
ヘッダ <cmath> で定義
|
||
float acosh ( float arg ); float acoshf( float arg ); |
(1) | (C++11以上) |
double acosh ( double arg ); |
(2) | (C++11以上) |
long double acosh ( long double arg ); long double acoshl( long double arg ); |
(3) | (C++11以上) |
double acosh ( 整数型 arg ); |
(4) | (C++11以上) |
1-3)
arg
の逆双曲線余弦を計算します。目次 |
[編集] 引数
arg | - | 浮動小数点または整数型の値 |
[編集] 戻り値
エラーが発生しなければ、区間 [0, +∞] 上の arg
の逆双曲線余弦 (cosh-1
(arg) または arcosh(arg)) が返されます。
定義域エラーが発生した場合、処理系定義の値 (サポートされていれば NaN) が返されます。
[編集] エラー処理
math_errhandling で規定されている通りにエラーが報告されます。
引数が 1 より小さい場合、定義域エラーが発生します。
処理系が IEEE 浮動小数点算術 (IEC 60559) をサポートしている場合、
- 引数が 1 より小さければ、 FE_INVALID が発生し、 NaN が返されます。
- 引数が 1 であれば、 +0 が返されます。
- 引数が +∞ であれば、 +∞ が返されます。
- 引数が NaN であれば、 NaN が返されます。
[編集] ノート
(この関数について C++ が参照している) C 標準は、この関数に「arc hyperbolic cosine」と名付けていますが、双曲線関数の逆関数は面積関数です。 引数は双曲的扇形の面積であり、円弧 (arc) ではありません。 正しい名前は「inverse hyperbolic cosine」 (POSIX で使用されています) または「area hyperbolic cosine」です。
[編集] 例
Run this code
#include <iostream> #include <cmath> #include <cfloat> #include <cerrno> #include <cfenv> #include <cstring> #pragma STDC FENV_ACCESS ON int main() { std::cout << "acosh(1) = " << std::acosh(1) << '\n' << "acosh(10) = " << std::acosh(10) << '\n' << "acosh(DBL_MAX) = " << std::acosh(DBL_MAX) << '\n' << "acosh(Inf) = " << std::acosh(INFINITY) << '\n'; // エラー処理 errno = 0; std::feclearexcept(FE_ALL_EXCEPT); std::cout << "acosh(0.5) = " << std::acosh(0.5) << '\n'; if (errno == EDOM) std::cout << " errno == EDOM: " << std::strerror(errno) << '\n'; if (std::fetestexcept(FE_INVALID)) std::cout << " FE_INVALID raised\n"; }
出力例:
acosh(1) = 0 acosh(10) = 2.99322 acosh(DBL_MAX) = 710.476 acosh(Inf) = inf acosh(0.5) = -nan errno == EDOM: Numerical argument out of domain FE_INVALID raised
[編集] 関連項目
(C++11)(C++11)(C++11) |
逆双曲線正弦 (arsinh(x)) を計算します (関数) |
(C++11)(C++11)(C++11) |
逆双曲線正接 (artanh(x)) を計算します (関数) |
(C++11)(C++11) |
双曲線余弦 (cosh(x)) を計算します (関数) |
(C++11) |
複素数の逆双曲線余弦 (arcosh(z)) を計算します (関数テンプレート) |
acosh の C言語リファレンス
|
[編集] 外部リンク
Weisstein, Eric W. "Inverse Hyperbolic Cosine." From MathWorld--A Wolfram Web Resource.