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

ヘッダー `<cmath>` で定義
	(1)
float atanh ( float num ); double atanh ( double num ); long double atanh ( long double num );			(C++23まで)
/浮動小数点数型/ atanh ( /浮動小数点型/ num );			(C++23から) (C++26 以降 constexpr)
float atanhf( float num );		(2)	(C++11以降) (C++26 以降 constexpr)
long double atanhl( long double num );		(3)	(C++11以降) (C++26 以降 constexpr)
SIMDオーバーロード (C++26以降)
ヘッダー `<simd>` で定義
template< /math-floating-point/ V > constexpr /deduced-simd-t/<V> atanh ( const V& v_num );		(S)	(C++26以降)
追加のオーバーロード (C++11以降)
ヘッダー `<cmath>` で定義
template< class Integer > double atanh ( Integer num );		(A)	(C++26 以降 constexpr)

1-3) num の逆双曲線正接を計算します。ライブラリは、パラメータの型として、すべての cv 修飾されていない浮動小数点型に対する std::atanh のオーバーロードを提供します。(C++23 以降)

S) SIMD オーバーロードは、v_num に対して要素ごとの std::atanh を実行します。

(定義については、math-floating-point および deduced-simd-t を参照してください。)

(C++26以降)

A) すべての整数型に対する追加のオーバーロードが提供されます。これらは double として扱われます。

(C++11以降)

C++ がこの関数に関して参照する C 標準では、この関数は「逆双曲線正接（arc hyperbolic tangent）」と名付けられていますが、双曲線関数の逆関数は面積関数です。引数は円弧ではなく、双曲線扇形の面積です。正しい名称は「逆双曲線正接（inverse hyperbolic tangent）（POSIXで使用）」または「面積双曲線正接（area hyperbolic tangent）」です。

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';
 
    // error handling
    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

[編集] 関連項目

asinhasinhfasinhl (C++11)(C++11)(C++11)	逆双曲線正弦を計算する (${\small\operatorname{arsinh}{x}}$ $arsinh(x)$ ) (関数) [編集]
acoshacoshfacoshl (C++11)(C++11)(C++11)	逆双曲線余弦を計算する (${\small\operatorname{arcosh}{x}}$ $arcosh(x)$ ) (関数) [編集]
tanhtanhftanhl (C++11)(C++11)	双曲線正接を計算する (${\small\tanh{x}}$ $tanh(x)$ ) (関数) [編集]
atanh(std::complex) (C++11)	複素数の逆双曲線正接 (エリアハイパボリックタンジェント) を計算する (${\small\operatorname{artanh}{z}}$ $artanh(z)$ ) (関数テンプレート) [編集]
C のドキュメント（atanh）

[編集] 外部リンク

Weisstein, Eric W. "Inverse Hyperbolic Tangent." MathWorld — A Wolfram Web Resource より。

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作

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

目次

[編集] パラメータ

[編集] 戻り値

[編集] エラー処理

[編集] 注記

[編集] 例

[編集] 関連項目

[編集] 外部リンク

ナビゲーション

ツールボックス

asinhasinhfasinhl (C++11)(C++11)(C++11)	逆双曲線正弦を計算する (\({\small\operatorname{arsinh}{x}}\) $arsinh(x)$ ) (関数) [編集]
acoshacoshfacoshl (C++11)(C++11)(C++11)	逆双曲線余弦を計算する (\({\small\operatorname{arcosh}{x}}\) $arcosh(x)$ ) (関数) [編集]
tanhtanhftanhl (C++11)(C++11)	双曲線正接を計算する (\({\small\tanh{x}}\) $tanh(x)$ ) (関数) [編集]
atanh(std::complex) (C++11)	複素数の逆双曲線正接 (エリアハイパボリックタンジェント) を計算する (\({\small\operatorname{artanh}{z}}\) $artanh(z)$ ) (関数テンプレート) [編集]
C のドキュメント（atanh）