在头文件中定义float asinf( float arg );(1)(since C99)
double asin( double arg );(2)
long double asinl( long double arg );(3)(since C99)
Defined in header
#define asin( arg )(4)(since C99)
1-3)计算弧的正弦值的主值arg。
4)类型 - 通用宏:如果参数具有类型long double,asinl则被调用。否则,如果参数具有整数类型或类型double,asin则调用该参数。否则,asinf被调用。如果参数是复杂的,则宏调用相应的复变函数(casinf,casin,casinl)。
参数
arg-浮点值
返回值
如果没有出现错误,arg则范围[ - (arcsin(arg))的反正弦值
| π |
|:----|
| 2 |
; +
| π |
|:----|
| 2 |
], is returned.
如果发生域错误,则返回实现定义的值(NaN,如果支持)。
如果由于下溢而发生范围错误,则返回正确的结果(舍入后)。
错误处理
按照math_errhandling中的指定报告错误。
如果arg超出范围,则会发生域错误[-1.0; 1.0]。
如果实现支持IEEE浮点运算(IEC 60559),
如果参数为±0,则不加修改地返回
如果| arg | > 1,发生域错误并返回NaN。
如果参数是NaN,则返回NaN
例
#include #include #include #include #include
#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.141593asin(-0.5) = -0.523599, 6*asin(-0.5)=-3.141593asin(0.0) = 0.000000, asin(-0.0)=-0.000000asin(1.1) = nan
errno == EDOM: Numerical argument out of domain
FE_INVALID raised
参考
C11标准(ISO / IEC 9899:2011):7.12.4.2 asin函数(p:238)
7.25类型通用数学(p:373-375)
F.10.1.2 asin函数(p:518)
C99标准(ISO / IEC 9899:1999):7.12.4.2 asin函数(p:219)
7.22类型通用数学(p:335-337)
F.9.1.2 asin函数(p:456)
C89 / C90标准(ISO / IEC 9899:1990):4.5.2.2 asin函数