cos, cosf, cosl
定义于头文件 <math.h>
|
||
float cosf( float arg ); |
(1) | (C99 起) |
double cos( double arg ); |
(2) | |
long double cosl( long double arg ); |
(3) | (C99 起) |
定义于头文件 <tgmath.h>
|
||
#define cos( arg ) |
(4) | (C99 起) |
1-3) 计算
arg
(以弧度计量)的余弦。4) 泛型宏:若参数拥有 long double 类型,则调用
cosl
。否则,若参数拥有整数类型或 double 类型,则调用 cos
。否则,调用 cosf
、若参数为复数,则该宏调用对应的复函数( ccosf 、 ccos 、 ccosl )。参数
arg | - | 以弧度表示角的浮点值 |
返回值
若不出现错误,则返回 arg
的余弦( cos(arg) ),在范围 [-1 ; +1] 中。
若 |
(C99 前) |
若出现定义域错误,则返回实现定义值(受支持平台上为 NaN )。
若出现下溢所致的值域错误,则返回(舍入后的)正确的结果。
错误处理
报告 math_errhandling 中指定的错误。
若实现支持 IEEE 浮点算术( IEC 60559 ),
- 则若参数为 ±0 ,则结果为 1.0
- 若参数为 ±∞ ,则返回 NaN 并引发 FE_INVALID
- 若参数为 NaN ,则返回 NaN
注意
参数为无穷大的情况不被指定为 C 中的定义域错误,但被定义为 POSIX 中的定义域错误。
示例
运行此代码
#include <stdio.h> #include <math.h> #include <errno.h> #include <fenv.h> #pragma STDC FENV_ACCESS ON int main(void) { double pi = acos(-1); // 典型用法 printf("cos(pi/3) = %f\n", cos(pi/3)); printf("cos(pi/2) = %f\n", cos(pi/2)); printf("cos(-3*pi/4) = %f\n", cos(-3*pi/4)); // 特殊值 printf("cos(+0) = %f\n", cos(0.0)); printf("cos(-0) = %f\n", cos(-0.0)); // 错误处理 feclearexcept(FE_ALL_EXCEPT); printf("cos(INFINITY) = %f\n", cos(INFINITY)); if(fetestexcept(FE_INVALID)) puts(" FE_INVALID raised"); }
可能的输出:
cos(pi/3) = 0.500000 cos(pi/2) = 0.000000 cos(-3*pi/4) = -0.707107 cos(+0) = 1.000000 cos(-0) = 1.000000 cos(INFINITY) = -nan FE_INVALID raised
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.12.4.5 The cos functions (p: 239)
- 7.25 Type-generic math <tgmath.h> (p: 373-375)
- F.10.1.5 The cos functions (p: 519)
- C99 standard (ISO/IEC 9899:1999):
- 7.12.4.5 The cos functions (p: 220)
- 7.22 Type-generic math <tgmath.h> (p: 335-337)
- F.9.1.5 The cos functions (p: 456)
- C89/C90 standard (ISO/IEC 9899:1990):
- 4.5.2.5 The cos function
参阅
(C99)(C99) |
计算正弦( sin(x) ) (函数) |
(C99)(C99) |
计算正切( tan(x) ) (函数) |
(C99)(C99) |
计算反余弦( arccos(x) ) (函数) |
(C99)(C99)(C99) |
计算复数余弦 (函数) |