atanh, atanhf, atanhl
From cppreference.com
| ヘッダー <math.h> で定義 |
||
| float atanhf( float arg ); |
(1) | (C99以降) |
| double atanh( double arg ); |
(2) | (C99以降) |
| long double atanhl( long double arg ); |
(3) | (C99以降) |
| ヘッダー <tgmath.h> で定義 |
||
| #define atanh( arg ) |
(4) | (C99以降) |
1-3) arg の逆双曲線正接を計算します。
4) 型汎用マクロ：引数の型が long double の場合、
atanhl が呼び出されます。それ以外の場合で、引数の型が整数型または double の場合、atanh が呼び出されます。それ以外の場合、atanhf が呼び出されます。引数が複素数の場合、マクロは対応する複素数関数（catanhf、catanh、catanhl）を呼び出します。目次 |
[編集] パラメータ
| arg | - | 双曲線扇形の面積を表す浮動小数点値 |
[編集] 戻り値
エラーが発生しなかった場合、arg の逆双曲線正接（tanh-1
(arg) または artanh(arg)）が返されます。
領域エラーが発生した場合、実装定義の値が返される (サポートされている場合はNaN)。
ポールエラーが発生した場合、（正しい符号を持つ）±HUGE_VAL、±HUGE_VALF、または ±HUGE_VALL が返されます。
アンダーフローによる範囲エラーが発生した場合、正確な結果 (丸め後) が返される。
[編集] エラー処理
エラーは math_errhandling で指定されたとおりに報告されます。
引数が区間 [-1, +1] にない場合、範囲エラーが発生します。
引数が ±1 の場合、ポールエラーが発生します。
実装がIEEE浮動小数点算術 (IEC 60559) をサポートしている場合、
- 引数が ±0 の場合、引数は変更されずに返されます。
- 引数が ±1 の場合、±∞ が返され、FE_DIVBYZERO が発生します。
- 引数の絶対値が 1 より大きい場合、NaN が返され、FE_INVALID が発生します。
- 引数が NaN の場合、NaN が返されます。
[編集] 注記
C 標準ではこの関数を「逆双曲線正接」と呼んでいますが、双曲線関数の逆関数は面積関数です。その引数は、弧ではなく双曲線扇形の面積です。正しい名称は「逆双曲線正接」（POSIX で使用）または「面積双曲線正接」です。
POSIX では、アンダーフローの場合、arg は変更されずに返され、それがサポートされない場合は、実装定義の値（DBL_MIN、FLT_MIN、および LDBL_MIN 以下の値）が返されると規定されています。
[編集] 例
このコードを実行
#include <errno.h> #include <fenv.h> #include <float.h> #include <math.h> #include <stdio.h> // #pragma STDC FENV_ACCESS ON int main(void) { printf("atanh(0) = %f\natanh(-0) = %f\n", atanh(0), atanh(-0.0)); printf("atanh(0.9) = %f\n", atanh(0.9)); // error handling errno = 0; feclearexcept(FE_ALL_EXCEPT); printf("atanh(-1) = %f\n", atanh(-1)); if (errno == ERANGE) perror(" errno == ERANGE"); if (fetestexcept(FE_DIVBYZERO)) puts(" FE_DIVBYZERO raised"); }
実行結果の例
atanh(0) = 0.000000
atanh(-0) = -0.000000
atanh(0.9) = 1.472219
atanh(-1) = -inf
errno == ERANGE: Numerical result out of range
FE_DIVBYZERO raised[編集] 参考文献
- C23標準 (ISO/IEC 9899:2024)
- 7.12.5.3 The atanh functions (p: 241)
- 7.25 型総称数学関数 <tgmath.h> (p: 373-375)
- F.10.2.3 The atanh functions (p: 520)
- C17標準 (ISO/IEC 9899:2018)
- 7.12.5.3 The atanh functions (p: TBD)
- 7.25 Type-generic math <tgmath.h> (p: TBD)
- F.10.2.3 The atanh functions (p: TBD)
- C11標準 (ISO/IEC 9899:2011)
- 7.12.5.3 The atanh functions (p: 241)
- 7.25 型総称数学関数 <tgmath.h> (p: 373-375)
- F.10.2.3 The atanh functions (p: 520)
- C99標準 (ISO/IEC 9899:1999)
- 7.12.5.3 The atanh functions (p: 221-222)
- 7.22 型総称数学関数 <tgmath.h> (p: 335-337)
- F.9.2.3 The atanh functions (p: 457)
[編集] 関連項目
| (C99)(C99)(C99) |
逆双曲線サインを計算する (arsinh(x)) (関数) |
| (C99)(C99)(C99) |
逆双曲線コサインを計算する (arcosh(x)) (関数) |
| (C99)(C99) |
双曲線タンジェントを計算する (tanh(x)) (関数) |
| (C99)(C99)(C99) |
複素アーク双曲線タンジェントを計算する (関数) |
| C++ ドキュメント （atanh）
| |
[編集] 外部リンク
| Weisstein, Eric W. "Inverse Hyperbolic Tangent." From MathWorld — A Wolfram Web Resource. |
