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