命名空间
变体
操作

cos、cosf、cosl

来自 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)
三角函数和双曲函数
cos
(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       cosf( float arg );
(1) (自 C99)
double      cos( double arg );
(2)
long double cosl( long double arg );
(3) (自 C99)
_Decimal32  cosd32( _Decimal32 arg );
(4) (自 C23)
_Decimal64  cosd64( _Decimal64 arg );
(5) (自 C23)
_Decimal128 cosd128( _Decimal128 arg );
(6) (自 C23)
在头文件 <tgmath.h> 中定义
#define cos( arg )
(7) (自 C99)
1-6) 计算 arg 的余弦值(以弧度为单位)。
7) 类型通用宏:如果参数的类型为 long double,则调用 (3) (cosl)。否则,如果参数的类型为整数类型或类型 double,则调用 (2) (cos)。否则,调用 (1) (cosf)。如果参数为复数,则宏调用相应的复数函数(ccosfccosccosl)。

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

(自 C23)

内容

[编辑] 参数

arg - 表示以弧度为单位的角度的浮点值

[编辑] 返回值

如果未发生错误,则返回 arg 的余弦值(cos(arg)),范围为 [-1 ; +1]

如果 arg 的大小很大,则结果可能没有意义或意义很小。

(直到 C99)

如果发生域错误,则返回一个实现定义的值(在支持的情况下返回 NaN)。

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

[编辑] 错误处理

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

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

  • 如果参数为 ±0,则结果为 1.0
  • 如果参数为 ±∞,则返回 NaN 并引发 FE_INVALID
  • 如果参数为 NaN,则返回 NaN。

[编辑] 说明

参数为无穷大的情况在 C 中未指定为域错误,但在 POSIX 中定义为域错误

[编辑] 示例

#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
 
#ifndef __GNUC__
#pragma STDC FENV_ACCESS ON
#endif
 
int main(void)
{
    const double pi = acos(-1);
 
    // typical usage
    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));
 
    // special values
    printf("cos(+0) = %f\n", cos(0.0));
    printf("cos(-0) = %f\n", cos(-0.0));
 
    // error handling
    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

[编辑] 参考文献

  • C23 标准 (ISO/IEC 9899:2024)
  • 7.12.4.5 cos 函数 (p: TBD)
  • 7.25 类型泛型数学 <tgmath.h> (p: TBD)
  • F.10.1.5 cos 函数 (p: TBD)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.12.4.5 cos 函数 (p: 174)
  • 7.25 类型泛型数学 <tgmath.h> (p: 272-273)
  • F.10.1.5 cos 函数 (p: 378)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.12.4.5 cos 函数 (p: 239)
  • 7.25 类型泛型数学 <tgmath.h> (p: 373-375)
  • F.10.1.5 cos 函数 (p: 519)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.12.4.5 cos 函数 (p: 220)
  • 7.22 类型泛型数学 <tgmath.h> (p: 335-337)
  • F.9.1.5 cos 函数 (p: 456)
  • C89/C90 标准 (ISO/IEC 9899:1990)
  • 4.5.2.5 cos 函数

[编辑] 参见

(C99)(C99)
计算正弦 (sin(x))
(函数) [编辑]
(C99)(C99)
计算正切 (tan(x))
(函数) [编辑]
(C99)(C99)
计算反余弦 (arccos(x))
(函数) [编辑]
(C99)(C99)(C99)
计算复数余弦
(函数) [编辑]
C++ 文档 for cos