名 前
atanh, atanhf, atanhl − 逆 双 曲 線 正 接 （ inverse hyperbolic tangent） 関 数
書 式
#include <math.h>
double
atanh(double x);
float atanhf(float x);
long double atanhl(long double x);
−lm で リ ン ク す る 。
glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):
atanh():
_BSD_SOURCE || _SVID_SOURCE ||
_XOPEN_SOURCE >= 500 ||
_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED ||
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
or cc −std=c99
atanhf(), atanhl():
_BSD_SOURCE || _SVID_SOURCE ||
_XOPEN_SOURCE >= 600 || _ISOC99_SOURCE ||
_POSIX_C_SOURCE >= 200112L;
or cc −std=c99
説 明
atanh() 関 数 は x の 逆 双 曲 線 正 接 (inverse hyperbolic tangent) を 計 算 す る 。 す な わ ち 、 そ の 双 曲 線 正 接 (hyperbolic tangent) が x に な る よ う な 値 で あ る 。
返 り 値
成 功 す る と 、 こ れ ら の 関 数 は x の 逆 双 曲 線 正 接 を 返 す 。
x が NaN の 場 合 、 NaN が 返 さ れ る 。
x が +0 (−0) の 場 合 、 +0 (−0) が 返 さ れ る 。
x が +1 か −1 の 場 合 、 極 エ ラ ー (pole error) が 発 生 し 、 関 数 の 種 類 に 応 じ て 、 数 学 的 に 正 し い 符 号 の HUGE_VAL, HUGE_VALF, HUGE_VALL が そ れ ぞ れ 返 さ れ る 。
x の 絶 対 値 が 1 よ り 大 き い 場 合 、 領 域 エ ラ ー (domain error) が 発 生 し 、 NaN が 返 さ れ る 。
エ ラ ー
こ れ ら の 関 数 を 呼 び 出 し た 際 に エ ラ ー が 発 生 し た か の 判 定 方 法 に つ い て の 情 報 は math_error(7) を 参 照 の こ と 。 以 下 の エ ラ ー が 発 生 す る 可 能 性 が あ る 。 領 域 エ ラ ー
(domain error): x が −1 よ り 小 さ い か +1 よ り 大 き い
errno に EDOM が 設 定 さ れ る 。 不 正 (invalid) 浮 動 小 数 点 例 外 (FE_INVALID) が 上 が る 。 極 エ ラ ー
(pole error): x が +1 か −1
errno に ERANGE が 設 定 さ れ る (「 バ グ 」 の 節 も 参 照 )。 0 に よ る 除 算 (divide−by−zero) 浮 動 小 数 点 例 外 (FE_DIVBYZERO) が 上 が る 。
準 拠
C99, POSIX.1−2001. double 版 の 関 数 は SVr4, 4.3BSD, C89 に も 準 拠 し て い る 。
バ グ
glibc 2.9 と そ れ 以 前 の バ ー ジ ョ ン で は 、 極 エ ラ ー が 発 生 し た 場 合 、 POSIX で 要 求 さ れ て い る ERANGE で は な く EDOM が errno に 設 定 さ れ る 。 バ ー ジ ョ ン 2.10 以 降 の glibc で は 、 正 し い 動 作 を す る 。
関 連 項 目
acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(3)
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。