atan2, atan2f, atan2l

函数

基本操作

abslabsllabsimaxabs (C99)(C99)
fabs
divldivlldivimaxdiv (C99)(C99)

fmod
remainder (C99)
remquo (C99)
fma (C99)
fdim (C99)
nannanfnanlnandN (C99)(C99)(C99)(C23)

最大值/最小值操作

fmax (C99)
fmin (C99)
fmaximum (C23)
fminimum (C23)
fmaximum_mag (C23)

fmaximum_num (C23)
fminimum_mag (C23)
fminimum_num (C23)
fmaximum_mag_num (C23)
fminimum_mag_num (C23)

指数函数

exp
exp10 (C23)
exp2 (C99)
expm1 (C99)
exp10m1 (C23)
exp2m1 (C23)

log
log10
log2 (C99)
log1plogp1 (C99)(C23)
log10p1 (C23)
log2p1 (C23)

幂函数

sqrt
cbrt (C99)
rootn (C23)
rsqrt (C23)

hypot (C99)
compound (C23)
pow
pown (C23)
powr (C23)

三角函数和双曲函数

sin
cos
tan
asin
acos
atan
atan2
sinpi (C23)
cospi (C23)
tanpi (C23)

asinpi (C23)
acospi (C23)
atanpi (C23)
atan2pi (C23)
sinh
cosh
tanh
asinh (C99)
acosh (C99)
atanh (C99)

最近整数浮点数

ceil
floor
roundlroundllround (C99)(C99)(C99)
roundeven (C23)
trunc (C99)

nearbyint (C99)
rintlrintllrint (C99)(C99)(C99)
fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23)

浮点数操作

ldexp
frexp
scalbnscalbln (C99)(C99)
ilogbllogb (C99)(C23)
logb (C99)

modf
nextafternexttoward (C99)(C99)
nextupnextdown (C23)(C23)
copysign (C99)
canonicalize (C23)

窄化操作

fadd (C23)
fsub (C23)
fmul (C23)

fdiv (C23)
ffma (C23)
fsqrt (C23)

量子与量子指数

quantizedN (C23)
quantumdN (C23)

samequantumdN (C23)
llquantexpdN (C23)

十进制重新编码函数

encodedecdN (C23)
decodedecdN (C23)

encodebindN (C23)
decodebindN (C23)

总序和载荷函数

totalorder (C23)
getpayload (C23)

setpayload (C23)
setpayloadsig (C23)

分类

fpclassify (C99)
iscanonical (C23)
isfinite (C99)
isinf (C99)
isnan (C99)
isnormal (C99)
signbit (C99)
issubnormal (C23)
iszero (C23)

isgreater (C99)
isgreaterequal (C99)
isless (C99)
islessequal (C99)
islessgreater (C99)
isunordered (C99)
issignaling (C23)
iseqsig (C23)

误差函数和伽马函数

erf (C99)
erfc (C99)

lgamma (C99)
tgamma (C99)

类型

div_tldiv_tlldiv_timaxdiv_t

(C99)(C99)

float_tdouble_t (C99)(C99)
_Decimal32_t_Decimal64_t (C23)(C23)

宏常量

特殊浮点值

HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN

(C99)(C99)(C23)

INFINITYDEC_INFINITY (C99)(C23)
NANDEC_NAN (C99)(C23)

参数和返回值

FP_ILOGB0FP_ILOGBNAN (C99)(C99)
FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)

FP_LLOGB0FP_LLOGBNAN (C23)(C23)
FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23)

错误处理

MATH_ERRNOMATH_ERRNOEXCEPT

(C99)(C99)

math_errhandling (C99)

快速操作指示符

FP_FAST_FMAFFP_FAST_FMA (C99)(C99)
FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23)
FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23)
FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23)

FP_FAST_FMALFP_FAST_FMADN (C99)(C23)
FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23)
FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23)
FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

[编辑]

定义于头文件 `<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 起)
_Decimal32 atan2d32( _Decimal32 y, _Decimal32 x );	(4)	(自 C23 起)
_Decimal64 atan2d64( _Decimal64 y, _Decimal64 x );	(5)	(自 C23 起)
_Decimal128 atan2d128( _Decimal128 y, _Decimal128 x );	(6)	(自 C23 起)
定义于头文件 `<tgmath.h>`
#define atan2( y, x )	(7)	(C99 起)

1-6) 计算 y / x 的反正切，使用参数的符号来确定正确的象限。

7) 泛型宏：如果任何参数的类型为 long double，则调用 (3) (atan2l)。否则，如果任何参数具有整数类型或类型为 double，则调用 (2) (atan2)。否则，调用 (1) (atan2f)。

函数 (4-6) 仅当实现预定义 __STDC_IEC_60559_DFP__（即实现支持十进制浮点数）时才声明。

(自 C23 起)

如果 x 和 y 都为零，则不会发生域错误；
如果 x 和 y 都为零，则也不会发生范围错误；
如果 y 为零，则不会发生极点错误；
如果 y 为 ±0 且 x 为负数或 -0，则返回 ±π；
如果 y 为 ±0 且 x 为正数或 +0，则返回 ±0；
如果 y 为 ±∞ 且 x 为有限值，则返回 ±π/2；
如果 y 为 ±∞ 且 x 为 -∞，则返回 ±3π/4；
如果 y 为 ±∞ 且 x 为 +∞，则返回 ±π/4；
如果 x 为 ±0 且 y 为负数，则返回 -π/2；
如果 x 为 ±0 且 y 为正数，则返回 +π/2；
如果 x 为 -∞ 且 y 为有限正数，则返回 +π；
如果 x 为 -∞ 且 y 为有限负数，则返回 -π；
如果 x 为 +∞ 且 y 为有限正数，则返回 +0；
如果 x 为 +∞ 且 y 为有限负数，则返回 -0；
如果 x 或 y 为 NaN，则返回 NaN。

[编辑] 注记

atan2(y, x) 等价于 carg(x + I*y)。

POSIX 指定，在下溢的情况下，返回 y / x 的值；如果不支持，则返回一个不大于 DBL_MIN、FLT_MIN 和 LDBL_MIN 的实现定义值。

[编辑] 示例

运行此代码

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    // normal usage: the signs of the two arguments determine the quadrant
    // atan2(1,1) = +pi/4, Quad I
    printf("(+1,+1) cartesian is (%f,%f) polar\n", hypot( 1, 1), atan2( 1, 1));
    // atan2(1, -1) = +3pi/4, Quad II
    printf("(+1,-1) cartesian is (%f,%f) polar\n", hypot( 1,-1), atan2( 1,-1));
    // atan2(-1,-1) = -3pi/4, Quad III
    printf("(-1,-1) cartesian is (%f,%f) polar\n", hypot(-1,-1), atan2(-1,-1));
    // atan2(-1,-1) = -pi/4, Quad IV
    printf("(-1,+1) cartesian is (%f,%f) polar\n", hypot(-1, 1), atan2(-1, 1));
 
    // special values
    printf("atan2(0, 0) = %f atan2(0, -0)=%f\n", atan2(0,0), atan2(0,-0.0));
    printf("atan2(7, 0) = %f atan2(7, -0)=%f\n", atan2(7,0), atan2(7,-0.0));
}

输出

(+1,+1) cartesian is (1.414214,0.785398) polar
(+1,-1) cartesian is (1.414214,2.356194) polar
(-1,-1) cartesian is (1.414214,-2.356194) polar
(-1,+1) cartesian is (1.414214,-0.785398) polar
atan2(0, 0) = 0.000000 atan2(0, -0)=3.141593
atan2(7, 0) = 1.570796 atan2(7, -0)=1.570796

[编辑] 参考

C23 标准 (ISO/IEC 9899:2024)

7.12.4.4 atan2 函数（p: TBD）

7.25 类型通用数学 <tgmath.h> (p: TBD)

F.10.1.4 atan2 函数（p: TBD）

C17 标准 (ISO/IEC 9899:2018)

7.12.4.4 atan2 函数（p: 174）

7.25 类型通用数学 <tgmath.h> (p: 272-273)

F.10.1.4 atan2 函数（p: 378）

C11 标准 (ISO/IEC 9899:2011)

7.12.4.4 atan2 函数（p: 239）

7.25 类型通用数学 <tgmath.h> (p: 373-375)

F.10.1.4 atan2 函数（p: 519）

C99 标准 (ISO/IEC 9899:1999)

7.12.4.4 atan2 函数（p: 219）

7.22 类型通用数学 <tgmath.h> (p: 335-337)

F.9.1.4 atan2 函数（p: 456）

C89/C90 标准 (ISO/IEC 9899:1990)

4.5.2.4 atan2 函数

[编辑] 另请参阅

asinasinfasinl (C99)(C99)	计算反正弦 (${\small\arcsin{x} }$ $arcsin(x)$ ) (函数) [编辑]
acosacosfacosl (C99)(C99)	计算反余弦 (${\small\arccos{x} }$ $arccos(x)$ ) (函数) [编辑]
atanatanfatanl (C99)(C99)	计算反正切 (${\small\arctan{x} }$ $arctan(x)$ ) (函数) [编辑]
cargcargfcargl (C99)(C99)(C99)	计算复数的幅角 (函数) [编辑]
C++ 文档 for atan2

编译器支持
语言
头文件
类型支持
程序工具
变参函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

常用数学函数
浮点环境 (C99)
伪随机数生成
复数运算 (C99)
类型通用数学 (C99)
位操作 (C23)
检查整数运算 (C23)

cppreference.cn

命名空间

变体

视图

操作

atan2, atan2f, atan2l

目录

[编辑] 参数

[编辑] 返回值

[编辑] 错误处理

[编辑] 注记

[编辑] 示例

[编辑] 参考

[编辑] 另请参阅

导航

工具箱

asinasinfasinl (C99)(C99)	计算反正弦 (\({\small\arcsin{x} }\) $arcsin(x)$ ) (函数) [编辑]
acosacosfacosl (C99)(C99)	计算反余弦 (\({\small\arccos{x} }\) $arccos(x)$ ) (函数) [编辑]
atanatanfatanl (C99)(C99)	计算反正切 (\({\small\arctan{x} }\) $arctan(x)$ ) (函数) [编辑]
cargcargfcargl (C99)(C99)(C99)	计算复数的幅角 (函数) [编辑]
C++ 文档 for atan2