atanh, atanhf, atanhl

来自cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本运算
(C99)
(C99)
(C99)
(C99)
(C99)
(C99)(C99)(C99)
指数函数
(C99)
(C99)
(C99)
(C99)
幂函数
(C99)
(C99)
三角及双曲函数
(C99)
(C99)
atanh
(C99)
误差及伽马函数
(C99)
(C99)
(C99)
(C99)
临近整数的浮点运算
(C99)(C99)(C99)
(C99)
(C99)(C99)(C99)
浮点数操作函数
(C99)(C99)
(C99)
(C99)
分类
(C99)
(C99)
(C99)
类型
(C99)(C99)
宏常量
 
定义于头文件 <math.h>
float       atanhf( float arg );
(1) (C99 起)
double      atanh( double arg );
(2) (C99 起)
long double atanhl( long double arg );
(3) (C99 起)
定义于头文件 <tgmath.h>
#define atanh( arg )
(4) (C99 起)
1-3) 计算 arg 的反双曲正切。
4) 泛型宏:若参数拥有 long double 类型,则调用 atanhl 。否则,若参数拥有整数类型或 double 类型,则调用 atanh 。否则调用 atanhf 。若参数为复数,则调用对应的复函数( catanhfcatanhcatanhl )。

参数

arg - 表示双曲扇形面积的浮点值

返回值

若不出现错误,则返回 arg 的反双曲正切( tanh-1
(arg)
artanh(arg) )。

若出现定义域错误,则返回实现定义值(若支持则为 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 <stdio.h>
#include <math.h>
#include <float.h>
#include <errno.h>
#include <fenv.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: Numerical result out of range
    FE_DIVBYZERO raised

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 7.12.5.3 The atanh functions (p: 241)
  • 7.25 Type-generic math <tgmath.h> (p: 373-375)
  • F.10.2.3 The atanh functions (p: 520)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.12.5.3 The atanh functions (p: 221-222)
  • 7.22 Type-generic math <tgmath.h> (p: 335-337)
  • F.9.2.3 The atanh functions (p: 457)

参阅

(C99)(C99)(C99)
计算反双曲正弦 (arsinh(x)
(函数)
(C99)(C99)(C99)
计算反双曲余弦 (arcosh(x)
(函数)
(C99)(C99)
计算双曲正切 (th(x)
(函数)
(C99)(C99)(C99)
计算复数反双曲正切
(函数)

外部链接

Weisstein, Eric W. “反双曲正切。”来自 MathWorld--A Wolfram Web Resource 。