asinf
asin, asinf, asinl
在头文件 | | |
---|---|---|
float asinf(float arg); | (1) | (自C99以来) |
双asin(double arg); | (2) | |
long double asinl(long double arg); | (3) | (自C99以来) |
在头文件<tgmath.h>中定义 | | |
#define asin(arg) | (4) | (自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,则不加修改地返回
例
#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):