在线文档教程
C
数值 | Numerics

asin

asin, asinf, asinl

在头文件中定义
float asinf( float arg (1)(since C99)
double asin( double arg (2)
long double asinl( long double arg (3)(since C99)
Defined in header <tgmath.h>
#define asin( arg )(4)(since C99)

1-3)计算弧的正弦值的主值arg

4)类型 - 通用宏:如果参数具有类型long doubleasinl则被调用。否则,如果参数具有整数类型或类型doubleasin则调用该参数。否则,asinf被调用。如果参数是复杂的,则宏调用相应的复变函数(casinfcasincasinl)。

参数

arg-浮点值

返回值

如果没有出现错误,arg则范围[ - (arcsin(arg))的反正弦值

| π |

|:----|

| 2 |

; +

| π |

|:----|

| 2 |

],返回。

如果发生域错误,则返回实现定义的值(NaN,如果支持)。

如果由于下溢而发生范围错误,则返回正确的结果(舍入后)。

错误处理

按照math_errhandling中的指定报告错误。

如果arg超出范围,则会发生域错误[-1.0; 1.0]

如果实现支持IEEE浮点运算(IEC 60559),

  • 如果参数为±0,则不加修改地返回

#include <math.h> #include <stdio.h> #include <errno.h> #include <fenv.h> #include <string.h> #pragma STDC FENV_ACCESS ON int main(void) { printf("asin( 1.0) = %+f, 2*asin( 1.0)=%+f\n", asin(1), 2*asin(1) printf("asin(-0.5) = %+f, 6*asin(-0.5)=%+f\n", asin(-0.5), 6*asin(-0.5) // special values printf("asin(0.0) = %1f, asin(-0.0)=%f\n", asin(+0.0), asin(-0.0) // error handling errno = 0; feclearexcept(FE_ALL_EXCEPT printf("asin(1.1) = %f\n", asin(1.1) if(errno == EDOM) perror(" errno == EDOM" if(fetestexcept(FE_INVALID)) puts(" FE_INVALID raised" }

可能的输出:

asin( 1.0) = +1.570796, 2*asin( 1.0)=+3.141593 asin(-0.5) = -0.523599, 6*asin(-0.5)=-3.141593 asin(0.0) = 0.000000, asin(-0.0)=-0.000000 asin(1.1) = nan errno == EDOM: Numerical argument out of domain FE_INVALID raised

参考

  • C11标准(ISO / IEC 9899:2011):