命名空间
变体
操作

atan、atanf、atanl

来自 cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
类型
(C99)(C99)    

(C99)(C99)    

函数
基本操作
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C23)    
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)
(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)
(C99)
(C23)
(C23)
三角函数和双曲函数
atan
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
误差函数和伽马函数
(C99)
(C99)
(C99)
(C99)
最接近整数的浮点操作
(C99)(C99)(C99)
(C99)
(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点操作函数
(C99)(C99)
(C99)(C23)
(C99)
缩窄操作
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子和量子指数函数
十进制重新编码函数
全序和有效载荷函数
分类
(C99)
(C99)
(C99)
(C23)
宏常量
特殊浮点值
(C99)(C23)
参数和返回值
(C99)(C99)(C99)(C99)(C99)    
错误处理
(C99)    

 
定义在头文件 <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).

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

(自 C23)

内容

[编辑] 参数

arg - 浮点值

[编辑] 返回值

如果未发生错误,则返回 arg 的反正切函数 (arctan(arg)),范围在 [-
π
2
 ; +
π
2
]
弧度内。

如果由于下溢导致范围错误,则返回正确的结果(舍入后)。

[编辑] 错误处理

错误报告方式如 math_errhandling 中所述。

如果实现支持 IEEE 浮点运算 (IEC 60559)

  • 如果参数为 ±0,则返回未修改的参数;
  • 如果参数为 +∞,则返回 +π/2;
  • 如果参数为 -∞,则返回 -π/2;
  • 如果参数为 NaN,则返回 NaN。

[编辑] 备注

POSIX 规范 指出,在下溢情况下,返回未修改的 arg,如果该操作不受支持,则返回一个实现定义的值,该值不超过 DBL_MINFLT_MINLDBL_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: 待定)
  • 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 函数

[编辑] 另请参阅

计算反正切,使用符号确定象限
(函数) [编辑]
(C99)(C99)
计算反正弦 (arcsin(x))
(函数) [编辑]
(C99)(C99)
计算反余弦 (arccos(x))
(函数) [编辑]
(C99)(C99)
计算正切 (tan(x))
(函数) [编辑]
(C99)(C99)(C99)
计算复数反正切
(函数) [编辑]
C++ 文档 for atan