asinl

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

4）类型 - 通用宏：如果参数具有类型long double，asinl则被调用。否则，如果参数具有整数类型或类型double，asin则调用该参数。否则，asinf被调用。如果参数是复杂的，则宏调用相应的复变函数（casinf，casin，casinl）。

参数

返回值

如果没有出现错误，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 <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）：
  • 7.12.4.2 asin函数（p：238）
  • 7.25类型通用数学<tgmath.h>（p：373-375）
  • F.10.1.2 asin函数（p：518）
• C99标准（ISO / IEC 9899：1999）：
  • 7.12.4.2 asin函数（p：219）
  • 7.22类型通用数学<tgmath.h>（p：335-337）
  • F.9.1.2 asin函数（p：456）
• C89 / C90标准（ISO / IEC 9899：1990）：
  • 4.5.2.2 asin函数