atanh, atanhf, atanhl

参数

返回值

如果未发生错误，则返回 arg 的反双曲正切值（ tanh -1
(arg) 或 artanh(arg) ）。

如果发生定义域错误，则返回一个由实现定义的值（在支持 NaN 的情况下返回 NaN）。

如果发生极点错误，将返回 ± HUGE_VAL 、 ±HUGE_VALF 或 ±HUGE_VALL （保留正确的符号）。

如果由于下溢发生范围错误，将返回正确结果（舍入后）。

错误处理

错误报告方式遵循 math_errhandling 中的规范。

如果参数不在区间 [ - 1 , + 1 ] 内，则会发生范围错误。

如果参数为 ±1，将出现极点错误。

如果实现支持 IEEE 浮点算术 (IEC 60559)，

• 若参数为 ±0，则不作修改直接返回。
• 若参数为 ±1，则返回 ±∞ 并引发 FE_DIVBYZERO 。
• 若 |arg|>1 ，则返回 NaN 并引发 FE_INVALID 。
• 若参数为 NaN，则返回 NaN。

注释

尽管C标准将此函数命名为"反双曲正切"，但双曲函数的反函数实际上是面积函数。它们的参数是双曲扇形的面积，而非弧长。正确的名称应为"反双曲正切"（POSIX使用）或"面积双曲正切"。

POSIX 规范 规定，在下溢情况下，将原样返回 arg ；若不支持此行为，则返回不大于 DBL_MIN 、 FLT_MIN 和 LDBL_MIN 的实现定义值。

示例

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("atanh(0) = %f\natanh(-0) = %f\n", atanh(0), atanh(-0.0));
    printf("atanh(0.9) = %f\n", atanh(0.9));
    // 错误处理
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("atanh(-1) = %f\n", atanh(-1));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_DIVBYZERO))
        puts("    FE_DIVBYZERO raised");
}

atanh(0) = 0.000000
atanh(-0) = -0.000000
atanh(0.9) = 1.472219
atanh(-1) = -inf
    errno == ERANGE: 数值结果超出范围
    FE_DIVBYZERO raised

参考文献

参考

外部链接