std::atan, std::atanf, std::atanl
来自 cppreference.com
| 在头文件 <cmath> 中定义 |
||
| (1) | ||
float atan ( float num ); double atan ( double num ); |
(直到 C++23) | |
| /* 浮点类型 */ atan ( /* 浮点类型 */ num ); |
(自 C++23) (自 C++26 起为 constexpr) |
|
| float atanf( float num ); |
(2) | (自 C++11) (自 C++26 起为 constexpr) |
| long double atanl( long double num ); |
(3) | (自 C++11) (自 C++26 起为 constexpr) |
| 其他重载 (自 C++11) |
||
| 在头文件 <cmath> 中定义 |
||
| template< class Integer > double atan ( Integer num ); |
(A) | (自 C++26 起为 constexpr) |
1-3) 计算 num 的反正切主值。 库为所有 cv 无限定浮点类型提供
std::atan 的重载，作为参数的类型。(自 C++23)|
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
| |
