std:: atanh, std:: atanhf, std:: atanhl

パラメータ

戻り値

エラーが発生しない場合、 num の逆双曲線正接（ tanh -1
(num) または artanh(num) ）が返されます。

定義域エラーが発生した場合、実装定義の値が返されます（NaNがサポートされている場合はNaN）。

極点エラーが発生した場合、 ±HUGE_VAL 、 ±HUGE_VALF または ±HUGE_VALL が（正しい符号で）返されます。

アンダーフローによる範囲エラーが発生した場合、正しい結果（丸め後）が返されます。

エラーハンドリング

エラーは math_errhandling で指定された通りに報告されます。

引数が区間 [ - 1 , + 1 ] 上にない場合、範囲エラーが発生します。

引数が±1の場合、極エラーが発生します。

IEEE浮動小数点演算（IEC 60559）を実装がサポートしている場合、

• 引数が±0の場合、変更されずに返されます。
• 引数が±1の場合、±∞が返され、 FE_DIVBYZERO が発生します。
• |num|>1 の場合、NaNが返され、 FE_INVALID が発生します。
• 引数がNaNの場合、NaNが返されます。

注記

C標準（C++はこの関数についてこれを参照する）ではこの関数を「逆双曲線正接」と命名しているが、双曲線関数の逆関数は面積関数である。それらの引数は双曲扇形の面積であり、弧ではない。正しい名称は「逆双曲線正接」（POSIXで使用）または「面積双曲線正接」である。

POSIXは アンダーフローが発生した場合、 num が変更されずに返され、それがサポートされていない場合は、 DBL_MIN 、 FLT_MIN 、および LDBL_MIN を超えない実装定義の値が返されることを規定しています。

追加のオーバーロードは (A) と完全に同一である必要はありません。それらは、整数型の引数 num に対して、 std :: atanh ( num ) が std :: atanh ( static_cast < double > ( num ) ) と同じ効果を持つことを保証するのに十分であればよいのです。

例

#include <cerrno>
#include <cfenv>
#include <cfloat>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "atanh(0) = " << std::atanh(0) << '\n'
              << "atanh(-0) = " << std::atanh(-0.0) << '\n'
              << "atanh(0.9) = " << std::atanh(0.9) << '\n';
    // エラーハンドリング
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "atanh(-1) = " << std::atanh(-1) << '\n';
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_DIVBYZERO))
        std::cout << "    FE_DIVBYZERO raised\n";
}

atanh(0) = 0
atanh(-0) = -0
atanh(0.9) = 1.47222
atanh(-1) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

関連項目

外部リンク