---
title: atanh
description: "计算输入实数的双曲反正切值。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0178.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0178.html
indexId: 863a7641b05f3b8b6ff22edbecc059bd9b8609e19a1380250b6b9133252765d561
---
# atanh

计算输入实数的双曲反正切值。

#### 接口定义

C interface：

float atanhf(float x);

double atanh(double x);

long double atanhl(long double x);

Fortran interface：

RES = ATANHF(X)

RES = ATANH(X)


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| x | 在atanhf中，x是单精度浮点类型。 在atanh中，x是双精度浮点类型。 在atanhl中，x是长双精度浮点类型。 | 表示输入数据的浮点值。 | 输入 |


#### 返回值

- 返回弧度角x的双曲反正切函数值y，x ∈ (-1, +1)。
- 输入+1，返回+∞。
- 输入-1，返回-∞。
- 输入|x| > 1，返回nan。
- 输入±∞，返回nan。
- 输入nan，返回nan。


#### 依赖

C: "km.h"


#### 示例

C interface：

```
double pi = acos(-1); 
    // typical usage 
    double a = pi/5, c = -3*pi/4, b = pi/8; 
    // special handling 
    double d = +0.0, h = -0.0, e = INFINITY, f = -INFINITY, g = NAN; 
    // print result 
    printf("atanh(pi/5) = %.15f\n", atanh(a)); 
    printf("atanh(-3*pi/4) = %.15f\n", atanh(c)); 
    printf("atanh(pi/8) = %.15f\n", atanh(b)); 
    printf("atanh(+0.0) = %+.15f\n", atanh(d)); 
    printf("atanh(-0.0) = %+.15f\n", atanh(h)); 
    printf("atanh(INFINITY) = %+.15f\n", atanh(e)); 
    printf("atanh(-INFINITY) = %+.15f\n", atanh(f)); 
    printf("atanh(NAN) = %.15f\n", atanh(g)); 
    /* 
     *  atanh(pi/3) = 0.738632981507743
     *  atanh(-3*pi/4) = nan
     *  atanh(pi/2) = 0.414987256841989 
     *  atanh(+0.0) = +0.000000000000000 
     *  atanh(-0.0) = -0.000000000000000 
     *  atanh(INFINITY) = +nan 
     *  atanh(-INFINITY) = +nan 
     *  atanh(NAN) = nan 
     * 
     * */
```

Fortran interface：

```
REAL(8) :: X = 0.0
PRINT*,  ATANH(X)
!
! OUTPUT
!     0.000000000000000
!
```