命名空间
变体
操作

asin, asinf, asinl

来自 cppreference.cn
< c‎ | 数值‎ | 数学
 
C
 
数值
 
常用数学函数
函数
基本操作
(C99)
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C99)
(C23)
(C23)
(C23) 
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)

(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)

(C99)
(C23)
(C23)
(C23)
三角函数和双曲函数
asin
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
最近整数浮点数
(C99)(C99)(C99)
(C23)
(C99)

(C99)
(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点数操作
(C99)(C99)
(C99)(C23)
(C99)
窄化操作
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子与量子指数
(C23)
(C23)
十进制重新编码函数
总序和载荷函数
分类
(C99)
(C23) 
(C99)
(C99)
(C99)
(C99)
(C99)
(C23)
(C23)
误差函数和伽马函数
(C99)
(C99)
(C99)
(C99)
类型
宏常量
特殊浮点值
(C99)(C23)
(C99)(C23)
参数和返回值
错误处理
快速操作指示符
 
定义于头文件 <math.h>
float       asinf( float arg );
 (1) (C99 起)
double      asin( double arg );
 (2)
long double asinl( long double arg );
 (3) (C99 起)
_Decimal32  asind32( _Decimal32 arg );
 (4) (自 C23 起)
_Decimal64  asind64( _Decimal64 arg );
 (5) (自 C23 起)
_Decimal128 asind128( _Decimal128 arg );
 (6) (自 C23 起)
定义于头文件 <tgmath.h>
#define asin( arg )
 (7) (C99 起)
1-6) 计算 arg 的主值反正弦。
7) 类型泛型宏：如果参数类型为 long double，则调用 (3) (asinl)。否则，如果参数类型为整数类型或 double，则调用 (2) (asin)。否则，调用 (1) (asinf)。如果参数是复数，则宏调用相应的复数函数（casinf, casin, casinl）。

函数 (4-6) 仅当实现预定义 __STDC_IEC_60559_DFP__（即实现支持十进制浮点数）时才声明。

 (自 C23 起)

目录

[编辑] 参数

arg - 浮点值

[编辑] 返回值

如果没有发生错误，返回 arg 的反正弦（arcsin(arg)），范围为 [-
π
2
 ; +
π
2
]。

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

如果因下溢发生范围错误，则返回正确结果（舍入后）。

[编辑] 错误处理

错误按 math_errhandling 中指定的方式报告。

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

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

  • 如果参数是 ±0，则原样返回；
  • 如果 |arg| > 1，则发生域错误并返回 NaN；
  • 如果参数为 NaN，则返回 NaN。

[编辑] 示例

运行此代码
#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
#include <string.h>
 
#ifndef __GNUC__
#pragma STDC FENV_ACCESS ON
#endif
 
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

[编辑] 参考

  • C23 标准 (ISO/IEC 9899:2024)
  • 7.12.4.2 asin 函数 (p: TBD)
  • 7.25 类型通用数学 <tgmath.h> (p: TBD)
  • F.10.1.2 asin 函数 (p: TBD)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.12.4.2 asin 函数 (p: 174)
  • 7.25 类型通用数学 <tgmath.h> (p: 272-273)
  • F.10.1.2 asin 函数 (p: 378)
  • 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 函数

[编辑] 另请参阅

(C99)(C99)
 计算反余弦 (arccos(x))
(函数) [编辑]
(C99)(C99)
 计算反正切 (arctan(x))
(函数) [编辑]
(C99)(C99)
 计算反正切，使用符号确定象限
(函数) [编辑]
(C99)(C99)
 计算正弦 (sin(x))
(函数) [编辑]
(C99)(C99)(C99)
 计算复反正弦
(函数) [编辑]
C++ 文档 用于 asin
取自“https://cppreference.cn/mwiki/index.php?title=c/numeric/math/asin&oldid=150034”