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）：