atan, atanf, atanl

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

数值

常用数学函数

浮点环境 (C99)

复数算术 (C99)

伪随机数生成

泛型数学 (C99)

 

常用数学函数

函数
基本运算 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大/最小运算 fmax (C99) fmaximum (C23) fmaximum_mag (C23) fmaximum_num (C23) fmaximum_mag_num (C23) fmin (C99) fminimum (C23) fminimum_mag (C23) fminimum_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)	误差及伽马函数 erf (C99) erfc (C99) lgamma (C99) tgamma (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) samequantumdN (C23) quantumdN (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)
类型
div_tldiv_tlldiv_timaxdiv_t (C99)(C99)	float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23)
宏常量
特殊浮点值 HUGE_VALFHUGE_VALHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 参数与返回值 FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARSTFROMZEROFP_INT_TONEARST (C23)(C23)(C23)(C23)(C23) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) 错误处理 math_errhandlingMATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)(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 起)
定义于头文件 <tgmath.h>
#define atan( arg )	(4)	(C99 起)

1-3) 计算 arg 的弧（反）正切主值。

4) 泛型宏：若参数拥有 long double 类型，则调用 atanl 。否则，若参数拥有整数类型或 double 类型，则调用 atan 。否则调用 atanf 。若参数为复数，则宏调用对应的复数函数（ catanf 、 catan 、 catanl ）。

参数

arg

-

浮点值

返回值

若不出现错误，则返回 arg 在 [-

π

2

 ; +

π

2

] 弧度范围中的弧（反）正切（ arctan(arg) ）。

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

错误处理

报告 math_errhandling 中指定的错误。

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

• 若参数为 ±0 ，则返回不修改的参数
• 若参数为 +∞ ，则返回 +π/2
• 若参数为 -∞ ，则返回 -π/2
• 若参数为 NaN ，则返回 NaN

注意

POSIX 指定在下溢情况下，返回不修改的 arg ，而若不支持如此，则返回不大于 DBL_MIN 、 FLT_MIN 和 LDBL_MIN 的实现定义值。

示例

运行此代码

#include <stdio.h>
#include <math.h>
 
int main(void)
{
    printf("atan(1) = %f, 4*atan(1)=%f\n", atan(1), 4*atan(1));
    // 特殊值
    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

引用

• C11 标准（ISO/IEC 9899:2011）：

• 7.12.4.3 The atan functions (p: 238-239)

• 7.25 Type-generic math <tgmath.h> (p: 373-375)

• F.10.1.3 The atan functions (p: 519)

• C99 标准（ISO/IEC 9899:1999）：

• 7.12.4.3 The atan functions (p: 219)

• 7.22 Type-generic math <tgmath.h> (p: 335-337)

• F.9.1.3 The atan functions (p: 456)

• C89/C90 标准（ISO/IEC 9899:1990）：

• 4.5.2.3 The atan function

参阅

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)	计算复数反正切 (函数)