函数
<cmath> <ctgmath>

asin

double asin(double x);
     double asin  (double x);      float asinf (float x);long double asinl (long double x);
     double asin (double x);      float asin (float x);long double asin (long double x);
     double asin (double x);      float asin (float x);long double asin (long double x);     double asin (T x);           // additional overloads for integral types
计算反正弦
返回 x 的反正弦主值,以弧度表示。

在三角学中,反正弦正弦的逆运算。

头文件 <tgmath.h> 提供了此函数的类型通用宏版本。
此函数在 <valarray> 中被重载(参见 valarray asin)。
此头文件 (<cmath>) 为整型类型提供了额外的重载:这些重载在计算前有效地将 x 转换为 double(为任何整型类型T 定义)。

此函数也在 <complex><valarray> 中被重载(参见 complex asinvalarray asin)。

参数

x
计算其反正弦的值,在区间 [-1,+1] 内。
如果参数超出此区间,会发生定义域错误

返回值

x 的反正弦主值,在区间 [-pi/2,+pi/2] 弧度内。
弧度等于 180/PI

如果发生定义域错误,全局变量 errno 会被设置为 EDOM
如果发生定义域错误
- 且 math_errhandling 设置了 MATH_ERRNO:全局变量 errno 会被设置为 EDOM
- 且 math_errhandling 设置了 MATH_ERREXCEPT:将引发 FE_INVALID

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
/* asin example */
#include <stdio.h>      /* printf */
#include <math.h>       /* asin */

#define PI 3.14159265

int main ()
{
  double param, result;
  param = 0.5;
  result = asin (param) * 180.0 / PI;
  printf ("The arc sine of %f is %f degrees\n", param, result);
  return 0;
}

输出

The arc sine of 0.500000 is 30.000000 degrees.


另见