Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

atanh，atanhf，atanhl-反双曲正切函数

语法

#include <math.h>

double atanh(double x);
float atanhf(float x);
long double atanhl(long double x);

Link with -lm.

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

atanh()：

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || _XOPEN_SOURCE>= 500 || / *自glibc 2.19起：* / -_DEFAULT_SOURCE || / * Glibc版本

atanhf()，atanhl()：

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || / *自glibc 2.19起：* / -_DEFAULT_SOURCE || / * Glibc版本

说明

这些函数计算x的反双曲正切值。那是双曲正切为x的值。

返回值

成功执行后，这些函数将返回x的反双曲正切值。

如果x为NaN，则返回NaN。

如果x为+0(-0)，则返回+0(-0)。

如果x为+1或-1，则会发生极坐标错误，并且函数将分别返回具有数学正确符号的HUGE_VAL，HUGE_VALF或HUGE_VALL。

如果x的绝对值大于1，则会发生域错误，并返回NaN。

错误说明

有关如何确定调用这些函数时是否发生错误的信息，请参见math_error(7)。

可能会发生以下错误：

Domain error: xless than -1 or greater than +1

errno设置为EDOM。引发了无效的浮点异常(FE_INVALID)。

Pole error: xis +1 or -1

errno设置为ERANGE(但请参阅BUGS)。产生了除零浮点异常(FE_DIVBYZERO)。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

C99，POSIX.1-2001，POSIX.1-2008。

返回double的变体还符合SVr4、4.3BSD。

BUGS

在glibc 2.9和更早版本中，当发生极点错误时，将errno设置为EDOM而不是POSIX要求的ERANGE。从2.10版开始，glibc做正确的事。

另外参见

acosh(3)，asinh(3)，catanh(3)，cosh(3)，sinh(3)，tanh(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。