命名空间
变体
操作

atan, atanf, atanl

来自 cppreference.cn
< c‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本运算
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大/最小值运算
(C99)
(C99)
指数函数
(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)
(C23)(C23)(C23)(C23)
浮点数操作
(C99)(C99)
(C99)(C23)
(C99)
窄化操作
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子和量子指数
十进制重新编码函数
总阶数和有效载荷函数
分类
(C99)
(C99)
(C99)
(C23)
误差和伽玛函数
(C99)
(C99)
(C99)
(C99)
类型
宏常量
特殊浮点数值
(C99)(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_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 函数 (页码:待定)
  • 7.25 类型泛型数学 <tgmath.h> (页码:待定)
  • F.10.1.3 atan 函数 (页码:待定)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.12.4.3 atan 函数 (页码:174)
  • 7.25 类型泛型数学 <tgmath.h> (页码:272-273)
  • F.10.1.3 atan 函数 (页码:378)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.12.4.3 atan 函数 (页码:238-239)
  • 7.25 类型泛型数学 <tgmath.h> (页码:373-375)
  • F.10.1.3 atan 函数 (页码:519)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.12.4.3 atan 函数 (页码:219)
  • 7.22 类型泛型数学 <tgmath.h> (页码:335-337)
  • F.9.1.3 atan 函数 (页码: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++ 文档 关于 atan