std::atan, std::atanf, std::atanl
来自 cppreference.cn
定义于头文件 <cmath> |
||
(1) | ||
float atan ( float num ); double atan ( double num ); |
(直到 C++23) | |
/*浮点类型*/ atan ( /*浮点类型*/ num ); |
(自 C++23 起) (constexpr 自 C++26 起) |
|
float atanf( float num ); |
(2) | (自 C++11 起) (constexpr 自 C++26 起) |
long double atanl( long double num ); |
(3) | (自 C++11 起) (constexpr 自 C++26 起) |
SIMD 重载 (自 C++26 起) |
||
定义于头文件 <simd> |
||
template< /*math-floating-point*/ V > constexpr /*deduced-simd-t*/<V> |
(S) | (自 C++26 起) |
附加重载 (自 C++11 起) |
||
定义于头文件 <cmath> |
||
template< class Integer > double atan ( Integer num ); |
(A) | (constexpr 自 C++26 起) |
1-3) 计算 num 的反正切主值。 库为所有 cv 非限定浮点类型提供了
std::atan
的重载作为参数类型。(自 C++23 起)
S) SIMD 重载对 v_num 执行元素级的
std::atan 。
|
(自 C++26 起) |
A) 为所有整数类型提供了附加重载,它们被视为 double。
|
(自 C++11 起) |
目录 |
[编辑] 参数
num | - | 浮点值或整数值 |
[编辑] 返回值
若未发生错误,则返回 num 的反正切 (arctan(num)),以弧度为单位,范围在 [-π |
2 |
π |
2 |
若发生下溢导致的范围错误,则返回正确结果(舍入后)。
[编辑] 错误处理
错误报告方式如 math_errhandling 中指定。
若实现支持 IEEE 浮点算术 (IEC 60559),
- 若参数为 ±0,则原样返回。
- 若参数为 +∞,则返回 +π/2。
- 若参数为 -∞,则返回 -π/2。
- 若参数为 NaN,则返回 NaN。
[编辑] 注解
POSIX 规定,在发生下溢的情况下,num 原样返回;如果不支持这样做,则返回一个实现定义的值,该值不大于 DBL_MIN、FLT_MIN 和 LDBL_MIN。
附加重载不一定完全如 (A) 所示提供。它们只需要足以确保对于整数类型的参数 num,std::atan(num) 与 std::atan(static_cast<double>(num)) 具有相同的效果。
[编辑] 示例
运行此代码
#include <cmath> #include <iostream> int main() { std::cout << "atan(1) = " << std::atan(1) << '\n' << "4*atan(1) = " << 4 * std::atan(1) << '\n'; // special values std::cout << "atan(Inf) = " << std::atan(INFINITY) << '\n' << "2*atan(Inf) = " << 2 * std::atan(INFINITY) << '\n' << "atan(-0.0) = " << std::atan(-0.0) << '\n' << "atan(+0.0) = " << std::atan(0) << '\n'; }
输出
atan(1) = 0.785398 4*atan(1) = 3.14159 atan(Inf) = 1.5708 2*atan(Inf) = 3.14159 atan(-0.0) = -0 atan(+0.0) = 0
[编辑] 参见
(C++11)(C++11) |
计算反正弦 (arcsin(x)) (函数) |
(C++11)(C++11) |
计算反余弦 (arccos(x)) (函数) |
(C++11)(C++11) |
反正切,使用符号确定象限 (函数) |
(C++11)(C++11) |
计算正切 (tan(x)) (函数) |
(C++11) |
计算复数的反正切 (arctan(z)) (函数模板) |
将函数 std::atan 应用于 valarray 的每个元素 (函数模板) | |
C 文档 关于 atan
|