C++11标准模板（STL）- 常用数学函数 - 计算反正切，以符号确定象限（std::atan2, std::atan2f, std::atan2l）

常用数学函数

计算反正切，以符号确定象限

std::atan2, 
std::atan2f, 
std::atan2l

定义于头文件 <math.h>
float       atan2f( float y, float x );	(1)	(C99 起)
double      atan2( double y, double x );	(2)
long double atan2l( long double y, long double x );	(3)	(C99 起)
定义于头文件 <tgmath.h>
#define atan2( arg )	(4)	(C99 起)

1-3) 计算 y/x 的弧（反）正切，以参数符号确定正确的象限。

4) 泛型宏：若任何参数拥有 long double 类型，则调用 atan2l 。否则，若任何参数拥有整数类型或 double 类型，则调用 atan2 。否则调用 atan2f 。

参数

x, y

-

浮点值

返回值

若不出现错误，则返回 y/x 在 [-π ; +π] 弧度范围中的弧（反）正切（ arctan(

y

x

) ）。

Y 参数

返回值

X 参数

若出现定义域错误，则返回实现定义值。

若出现下溢所致的值域错误，则返回（舍入后的）正确结果。

错误处理

报告 math_errhandling 中指定的错误。

若 x 与 y 均为零则可能出现定义域错误。

若实现支持 IEEE 浮点算术（ IEC 60559 ），则

• 若 x 与 y 均为零，则定义域错误不出现
• 若 x 与 y 均为零，则也不出现值域错误
• 若 y 为零，则不出现极点错误
• 若 y 为 ±0 且 x 为负或 -0 ，则返回 ±π
• 若 y 为 ±0 且 x 为正或 +0 ，则返回 ±0
• 若 y 为 ±∞ 且 x 有限，则返回 ±π/2
• 若 y 为 ±∞ 且 x 为 -∞ ，则返回 ±3π