---
title: asinh
description: "计算实数的双曲反正弦值。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2200/accel/kunpengaccel_kml_16_0244.html
sourcePath: /source/zh/kunpengboostkithistory/2200/accel/kunpengaccel_kml_16_0244.html
indexId: 19aa84790ea2482a2aca00ef4bb653756ac5c46abff7cfaf2c0f04d4c4f47d6374
---
# asinh

计算实数的双曲反正弦值。

#### 接口定义

C interface：

float asinhf(float x);

double asinh(double x);

Fortran interface：

RES = ASINHF(X);

RES = ASINH(X);


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| x | 在asinhf中，x是单精度浮点类型。 在asinh中，x是双精度浮点类型。 | 表示弧度角的浮点值。 | 输入 |


#### 返回值

- 返回弧度角x的双曲反正弦函数值y。
- 输入+0，返回+0。
- 输入-0，返回-0。
- 输入±∞，返回±∞。
- 输入nan，返回nan。


#### 依赖

C: "km.h"

Fortran: "km.f03"


#### 示例

C interface：

```
double pi = acos(-1);
// typical usage
double a = pi/6, b = 1.0, c = -3*pi/4, d = pi/3;
// special handling
double e = INFINITY, f = -INFINITY, g = NAN;
// print result
printf("asinh(pi/6) = %.15f\n", asinh(a));
printf("asinh(1.0) = %.15f\n", asinh(b));
printf("asinh(-3*pi/4) = %.15f\n", asinh(c));
printf("asinh(pi/3) = %.15f\n", asinh(d));
printf("asinh(INFINITY) = %.15f\n", asinh(e));
printf("asinh(-INFINITY) = %.15f\n", asinh(f));
printf("asinh(NAN) = %.15f\n", asinh(g));
/*
*  asinh(pi/6) = 0.502218985034611
*  asinh(1.0) = 0.881373587019543
*  asinh(-3*pi/4) = -1.592457372858543
*  asinh(pi/3) = 0.914356655392886
*  asinh(INFINITY) = inf
*  asinh(-INFINITY) = -inf
*  asinh(NAN) = nan
*
* */
```

Fortran interface：

```
REAL(8) :: X = 1.0
PRINT*,  ASINH(X)
!
! OUTPUT
!     0.881373587019543
!
```