---
title: asinpi
description: "计算输入实数的反正弦值除以π。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengaccel/math-lib/devg-kml/kunpengaccel_kml_0148.html
sourcePath: /source/zh/kunpengaccel/math-lib/devg-kml/kunpengaccel_kml_0148.html
indexId: 31c42c99c27601c0e3ab731f1d97b47c1cea8d9bb93ca04ca86285b0cdae25d568
---
# asinpi

计算输入实数的反正弦值除以π。

#### 接口定义

C interface：

float asinpif(float x);

double asinpi(double x);


#### 参数

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


#### 返回值

- 返回输入实数x的反正弦函数值除以π的值y=asin(x) / π，y ∈ [-0.5, +0.5]。

- 输入+0，返回+0。
- 输入-0，返回-0。
- 输入x为±1，返回±0.5。
- 输入|x|>1，返回nan。
- 输入±∞，返回nan。
- 输入nan，返回nan。


#### 依赖

C: "km.h"


#### 示例

C interface：

```
// print result
    printf("asinpi(0.0) = %.15f\n", asinpi(0.0));
    printf("asinpi(-0.0) = %.15f\n", asinpi(-0.0));
    printf("asinpi(0.25) = %.15f\n", asinpi(0.25));
    printf("asinpi(-0.25) = %.15f\n", asinpi(-0.25));
    printf("asinpi(0.5) = %.15f\n", asinpi(0.5));
    printf("asinpi(-0.5) = %.15f\n", asinpi(-0.5));
    printf("asinpi(1.0) = %.15f\n", asinpi(1.0));
    printf("asinpi(-1.0) = %.15f\n", asinpi(-1.0));
    printf("asinpi(INFINITY) = %.15f\n", asinpi(INFINITY));
    printf("asinpi(-INFINITY) = %.15f\n", asinpi(-INFINITY));
    printf("asinpi(NAN) = %.15f\n", asinpi(NAN));
    printf("asinpi(-NAN) = %.15f\n", asinpi(-NAN));
    /* 
     * asinpi(0.0) = 0.000000000000000
     * asinpi(-0.0) = -0.000000000000000
     * asinpi(0.25) = 0.080430623255166
     * asinpi(-0.25) = -0.080430623255166
     * asinpi(0.5) = 0.166666666666667
     * asinpi(-0.5) = -0.166666666666667
     * asinpi(1.0) = 0.500000000000000
     * asinpi(-1.0) = -0.500000000000000
     * asinpi(INFINITY) = nan
     * asinpi(-INFINITY) = nan
     * asinpi(NAN) = nan
     * asinpi(-NAN) = -nan
     * 
     * */
```