命名空间
变体
操作

std::atan, std::atanf, std::atanl

来自 cppreference.cn
< cpp‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本运算
(C++11)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
指数函数
(C++11)
(C++11)

(C++11)
(C++11)
幂函数
(C++11)
(C++11)
三角函数
双曲函数
(C++11)
(C++11)
(C++11)

误差和伽马函数
(C++11)
(C++11)
(C++11)
(C++11)
最近整数浮点运算
(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
浮点数操作函数
(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)
分类和比较
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
类型
(C++11)
(C++11)
(C++11)
宏常量
分类
(C++11)(C++11)(C++11)(C++11)(C++11)


 
定义于头文件 <cmath>
(1)
float       atan ( float num );

double      atan ( double num );

long double atan ( long 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>

            atan ( const V& v_num );
(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
(有关定义,参见 math-floating-pointdeduced-simd-t。)
(自 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_MINFLT_MINLDBL_MIN

附加重载不一定完全如 (A) 所示提供。它们只需要足以确保对于整数类型的参数 numstd::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))
(函数) [编辑]
计算复数的反正切 (arctan(z))
(函数模板) [编辑]
将函数 std::atan 应用于 valarray 的每个元素
(函数模板) [编辑]
C 文档 关于 atan