---
title: asin
description: "计算输入正弦值的反正弦值。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_kml_16_0239.html
sourcePath: /source/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_kml_16_0239.html
indexId: ac460ae9c9e564c2af7f36e3560ce232b20a60ee155b765f68b1a29b92ce445d76
---
# asin

计算输入正弦值的反正弦值。

#### 接口定义

C interface：

float asinf(float x);

double asin(double x);

long double asinl(long double x);

Fortran interface：

RES = ASINF(X);

RES = ASIN(X);


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| x | 在asinf中，x是单精度浮点类型。 在asin中，x是双精度浮点类型。 在asinl中，x是长双精度浮点类型。 | 表示正弦值的浮点值。 | 输入 |


#### 返回值

- 返回正弦值x的反正弦函数值y，x ∈ [-1, +1]。
- 输入+0，返回+0。
- 输入-0，返回-0。
- 输入x为±1，返回±π/2。
- 输入|x| > 1，返回nan。
- 输入±∞，返回nan。
- 输入nan，返回nan。


#### 依赖

C: "km.h"


#### 示例

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("asin(pi/6) = %.15f\n", asin(a));
printf("asin(1.0) = %.15f\n", asin(b));
printf("asin(-3*pi/4) = %.15f\n", asin(c));
printf("asin(pi/3) = %.15f\n", asin(d));
printf("asin(INFINITY) = %.15f\n", asin(e));
printf("asin(-INFINITY) = %.15f\n", asin(f));
printf("asin(NAN) = %.15f\n", asin(g));
/*
*  asin(pi/6) = 0.551069583099446
*  asin(1.0) = 1.570796326794897
*  asin(-3*pi/4) = nan
*  asin(pi/3) = nan
*  asin(INFINITY) = nan
*  asin(-INFINITY) = nan
*  asin(NAN) = nan
*
* */
```

Fortran interface：

```
REAL(8) :: X = 1.0
PRINT*,  ASIN(X)
!
! OUTPUT
!     1.570796326794897
!
```