atan、atanf、atanl

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

數值

常用數學函式

浮點環境 (C99)

偽隨機數生成

複數運算 (C99)

型別通用數學 (C99)

位操作 (C23)

檢查整數運算 (C23)

 

常用數學函式

函式 基本操作 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       atanf( float arg );	(1)	(C99 起)
double      atan( double arg );	(2)
long double atanl( long double arg );	(3)	(C99 起)
_Decimal32  atand32( _Decimal32 arg );	(4)	(自 C23 起)
_Decimal64  atand64( _Decimal64 arg );	(5)	(自 C23 起)
_Decimal128 atand128( _Decimal128 arg );	(6)	(自 C23 起)
定義於標頭檔案 <tgmath.h>
#define atan( arg )	(7)	(C99 起)

1-6) 計算 arg 的主值反正切。

7) 泛型宏：若引數型別為 long double，則呼叫 (3) (atanl)。否則，若引數為整數型別或型別為 double，則呼叫 (2) (atan)。否則，呼叫 (1) (atanf)。若引數為複數，則宏呼叫對應的複數函式（catanf、catan、catanl）。

函式 (4-6) 僅當實現預定義 __STDC_IEC_60559_DFP__（即實現支援十進位制浮點數）時才宣告。

(自 C23 起)

引數

arg

-

浮點值

返回值

若無錯誤發生，則返回 arg 的反正切（arctan(arg)），以弧度計，在範圍 [-

π

2

 ; +

π

2

] 內。

如果因下溢發生範圍錯誤，則返回正確結果（舍入後）。

錯誤處理

錯誤按 math_errhandling 中指定的方式報告。

如果實現支援 IEEE 浮點算術 (IEC 60559)

• 如果引數是 ±0，則原樣返回；
• 若引數為 +∞，則返回 +π/2；
• 若引數為 -∞，則返回 -π/2；
• 如果引數為 NaN，則返回 NaN。

注意

POSIX 指定，在下溢情況下，arg 未經修改返回，若不支援則返回不大於 DBL_MIN、FLT_MIN 和 LDBL_MIN 的實現定義值。

示例

執行此程式碼

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("atan(1) = %f, 4*atan(1)=%f\n", atan(1), 4 * atan(1));
    // special values
    printf("atan(Inf) = %f, 2*atan(Inf) = %f\n", atan(INFINITY), 2 * atan(INFINITY));
    printf("atan(-0.0) = %+f, atan(+0.0) = %+f\n", atan(-0.0), atan(0));
}

輸出

atan(1) = 0.785398, 4*atan(1)=3.141593
atan(Inf) = 1.570796, 2*atan(Inf) = 3.141593
atan(-0.0) = -0.000000, atan(+0.0) = +0.000000

參考

• C23 標準 (ISO/IEC 9899:2024)

• 7.12.4.3 atan 函式 (p: 待定)

• 7.25 型別通用數學 <tgmath.h> (p: TBD)

• F.10.1.3 atan 函式 (p: 待定)

• C17 標準 (ISO/IEC 9899:2018)

• 7.12.4.3 atan 函式 (p: 174)

• 7.25 型別通用數學 <tgmath.h> (p: 272-273)

• F.10.1.3 atan 函式 (p: 378)

• C11 標準 (ISO/IEC 9899:2011)

• 7.12.4.3 atan 函式 (p: 238-239)

• 7.25 型別通用數學 <tgmath.h> (p: 373-375)

• F.10.1.3 atan 函式 (p: 519)

• C99 標準 (ISO/IEC 9899:1999)

• 7.12.4.3 atan 函式 (p: 219)

• 7.22 型別通用數學 <tgmath.h> (p: 335-337)

• F.9.1.3 atan 函式 (p: 456)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 4.5.2.3 atan 函式

亦參見

atan2atan2fatan2l (C99)(C99)	計算反正切，使用符號確定象限 (函式)
asinasinfasinl (C99)(C99)	計算反正弦 (\({\small\arcsin{x} }\)arcsin(x)) (函式)
acosacosfacosl (C99)(C99)	計算反餘弦 (\({\small\arccos{x} }\)arccos(x)) (函式)
tantanftanl (C99)(C99)	計算正切 (\({\small\tan{x} }\)tan(x)) (函式)
catancatanfcatanl (C99)(C99)(C99)	計算復反正切 (函式)
C++ 文件 用於 atan