Cos

定义于头文件 <cmath> 中。

描述

计算 num（以弧度表示）的余弦值。该库为所有 cv-unqualified 浮点类型提供了 std::sin 的重载，作为参数 num 的类型。 (自 C++23 起)
附加重载为所有整数类型提供，它们被视为 double (自 C++11 起).

声明

C++23

// 1)
/* floating-point-type */ cos( /* floating-point-type */ num );
// 2)
float cosf( float num );
// 3)
long double cosl( long double num );

附加重载

// 4)
template< class Integer >
double cos ( Integer num );

C++11

// 1)
float cos ( float num );
// 2)
double cos ( double num );
// 3)
long double cos ( long double num );
// 4)
float cosf( float num );
// 5)
long double cosl( long double num );

附加重载

// 6)
template< class Integer >
double cos ( Integer num );

参数

num - 表示弧度角值的浮点或整数值

返回值

如果没有错误发生，则返回 num 的余弦值 (cos(num))，范围为 [-1, +1]。

如果 num 的量级很大，结果可能意义不大或没有意义。(直到 C++11)

如果发生域错误，则返回实现定义的值（如果支持，返回 NaN）。

如果因下溢导致范围错误，则返回正确结果（舍入后）。

错误处理

错误按 math_errhandling 中指定的方式报告。

如果实现支持 IEEE 浮点运算（IEC 60559）

如果参数是 ±0，结果是 1.0；如果参数是 ±∞，返回 NaN 并引发 FE_INVALID；如果参数是 NaN，返回 NaN。

备注

在 C 语言中，参数为无穷大的情况未指定为域错误，但在 POSIX 中将其定义为域错误。

不要求提供的附加重载与附加重载完全一致。它们只需足以确保对于整数类型的参数 num，
std::cos(num) 的效果与 std::cos(static_cast<double>(num)) 相同。

示例

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <iostream>
#include <numbers>
 
// #pragma STDC FENV_ACCESS ON
const double pi = std::numbers::pi; // or std::acos(-1) before C++20
 
int main()
{
    // typical usage
    std::cout 
        << "cos(pi/3) = " 
        << std::cos(pi / 3) << '\n'
        << "cos(pi/2) = " 
        << std::cos(pi / 2) << '\n'
        << "cos(-3*pi/4) = " 
        << std::cos(-3 * pi / 4) << '\n';
 
    // special values
    std::cout 
        << "cos(+0) = " 
        << std::cos(0.0) << '\n'
        << "cos(-0) = " 
        << std::cos(-0.0) << '\n';
 
    // error handling
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout 
        << "cos(INFINITY) = " 
        << std::cos(INFINITY) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout 
            << "FE_INVALID raised\n";
}

可能结果

cos(pi/3) = 0.5
cos(pi/2) = 6.12323e-17
cos(-3*pi/4) = -0.707107
cos(+0) = 1
cos(-0) = 1
cos(INFINITY) = -nan
FE_INVALID raised