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.com

名稱空間

變體

檢視

操作

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