std::asin, std::asinf, std::asinl

定义在头文件 `<cmath>` 中
	(1)
float asin ( float num ); double asin ( double num ); long double asin ( long double num );			(直到 C++23)
/* 浮点类型 / asin ( / 浮点类型 */ num );			(自 C++23 起) (自 C++26 起为 constexpr)
float asinf( float num );		(2)	(自 C++11 起) (自 C++26 起为 constexpr)
long double asinl( long double num );		(3)	(自 C++11 起) (自 C++26 起为 constexpr)
其他重载 (自 C++11 起)
定义在头文件 `<cmath>` 中
template< class Integer > double asin ( Integer num );		(A)	(自 C++26 起为 constexpr)

1-3) 计算 num 的反正弦的主值。库为所有 cv 无限定浮点类型提供 std::asin 的重载，作为参数的类型。(自 C++23 起)

A) 为所有整数类型提供其他重载，这些类型将被视为 double.

(自 C++11 起)

[编辑] 参数

num

-

浮点或整数值

[编辑] 返回值

如果未发生错误，则返回 num 的反正弦 (

arcsin(num)

)，范围为

[- π 2, + π 2]

.

如果发生域错误，则返回实现定义的值（在支持的情况下为 NaN）。

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

[编辑] 错误处理

错误的报告方式如 math_errhandling 中所述。

如果 num 超出范围 [-1.0, 1.0]，则会发生域错误。

如果实现支持 IEEE 浮点运算（IEC 60559），

如果参数为 ±0，则会返回未修改的参数。
如果 $|num| > 1$ ，则会发生域错误，并返回 NaN。
如果参数为 NaN，则返回 NaN。

[编辑] 说明

不需要按 (A) 中那样完全提供其他重载。它们只需要足以确保对于其整数类型的参数 num，std::asin(num) 与 std::asin(static_cast<double>(num)) 具有相同的效果。

[编辑] 示例

运行此代码

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
 
// #pragma STDC FENV_ACCESS ON
 
int main()
{
    std::cout << "asin(1.0) = " << asin(1) << '\n'
              << "2*asin(1.0) = " << 2 * asin(1) << '\n'
              << "asin(-0.5) = " << asin(-0.5) << '\n'
              << "6*asin(-0.5) =" << 6 * asin(-0.5) << '\n';
 
    // special values
    std::cout << "asin(0.0) = " << asin(0) << " asin(-0.0)=" << asin(-0.0) << '\n';
 
    // error handling
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "asin(1.1) = " << asin(1.1) << '\n';
 
    if (errno == EDOM)
        std::cout << "    errno == EDOM: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised" << '\n';
}

可能的输出

asin(1.0) = 1.5708
2*asin(1.0) = 3.14159
asin(-0.5) = -0.523599
6*asin(-0.5) = -3.14159
asin(0.0) = 0 asin(-0.0)=-0
asin(1.1) = nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

[编辑] 另请参见

acosacosfacosl (C++11)(C++11)	计算反余弦 (${\small\arccos{x}}$ $arccos(x)$ ) (函数) [编辑]
atanatanfatanl (C++11)(C++11)	计算反正切 (${\small\arctan{x}}$ $arctan(x)$ ) (函数) [编辑]
atan2atan2fatan2l (C++11)(C++11)	反正切，使用符号来确定象限 (函数) [编辑]
sinsinfsinl (C++11)(C++11)	计算正弦 (${\small\sin{x}}$ $sin(x)$ ) (函数) [编辑]
asin(std::complex) (C++11)	计算复数的反正弦 (${\small\arcsin{z}}$ $arcsin(z)$ ) (函数模板) [编辑]
asin(std::valarray)	将函数 std::asin 应用于 valarray 的每个元素 (函数模板) [编辑]
C 文档 for asin

编译器支持
独立和托管
语言
标准库
标准库头文件
命名需求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作