ATANH - Linux手册页
时间:2019-08-20 17:59:54 来源:igfitidea点击:
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)。
Interface | Attribute | Value |
atanh(),atanhf(),atanhl() | Thread safety | MT-Safe |
遵循规范
C99,POSIX.1-2001,POSIX.1-2008。
返回double的变体还符合SVr4、4.3BSD。
BUGS
在glibc 2.9和更早版本中,当发生极点错误时,将errno设置为EDOM而不是POSIX要求的ERANGE。从2.10版开始,glibc做正确的事。
出版信息
这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本,请访问https://www.kernel.org/doc/man-pages/。