Namespaces
Variants

std:: cos, std:: cosf, std:: cosl

From ru.cppreference.net
Common mathematical functions
Nearest integer floating point operations
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
Определено в заголовке <cmath>
(1)
float cos ( float num ) ;

double cos ( double num ) ;

long double cos ( long double num ) ;
(до C++23)
/*floating-point-type*/
cos ( /*floating-point-type*/ num ) ;
(начиная с C++23)
(constexpr начиная с C++26)
float cosf ( float num ) ;
(2) (начиная с C++11)
(constexpr начиная с C++26)
long double cosl ( long double num ) ;
(3) (начиная с C++11)
(constexpr начиная с C++26)
SIMD перегрузка (начиная с C++26)
Определено в заголовке <simd>
template < /*math-floating-point*/ V >

constexpr /*deduced-simd-t*/ < V >

cos ( const V & v_num ) ;
(S) (начиная с C++26)
Определено в заголовке <cmath>
template < class Integer >
double cos ( Integer num ) ;
(A) (constexpr начиная с C++26)
1-3) Вычисляет косинус num (измеряется в радианах). Библиотека предоставляет перегрузки std::cos для всех cv-неквалифицированных типов с плавающей запятой в качестве типа параметра. (since C++23)
S) SIMD перегрузка выполняет поэлементное вычисление std::cos для v_num .
(См. math-floating-point и deduced-simd-t для их определений.)
(since C++26)
A) Дополнительные перегрузки предоставляются для всех целочисленных типов, которые трактуются как double .
(since C++11)

Содержание

Параметры

num - значение с плавающей точкой или целое число, представляющее угол в радианах

Возвращаемое значение

Если ошибок не возникает, возвращается косинус num ( cos(num) ) в диапазоне [ - 1.0 , + 1.0 ] .

Результат может иметь незначительную или нулевую значимость, если величина num велика.

(until C++11)

Если происходит ошибка области определения, возвращается значение, определяемое реализацией (NaN, если поддерживается).

Если происходит ошибка диапазона из-за потери значимости (underflow), возвращается корректный результат (после округления).

Обработка ошибок

Ошибки сообщаются, как указано в math_errhandling .

Если реализация поддерживает арифметику с плавающей запятой IEEE (IEC 60559),

  • если аргумент равен ±0, результат равен 1.0 .
  • если аргумент равен ±∞, возвращается NaN и возбуждается FE_INVALID .
  • если аргумент равен NaN, возвращается NaN.

Примечания

Случай, когда аргумент бесконечен, не указан как domain error в C, но определён как domain error в POSIX .

Дополнительные перегрузки не обязаны быть предоставлены в точности как (A) . Они лишь должны быть достаточными для обеспечения того, чтобы для их аргумента num целочисленного типа, std :: cos ( num ) имел тот же эффект, что и std :: cos ( static_cast < double > ( num ) ) .

Пример

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <iomanip>
#include <iostream>
#include <numbers>
// #pragma STDC FENV_ACCESS ON
constexpr double pi = std::numbers::pi; // или std::acos(-1) до C++20
constexpr double your_cos(double x)
{
    double cos{1}, pow{x};
    for (auto fac{1ull}, n{1ull}; n != 19; fac *= ++n, pow *= x)
        if ((n & 1) == 0)
            cos += (n & 2 ? -pow : pow) / fac;
    return cos;
}
int main()
{
    std::cout << std::setprecision(10) << std::showpos
              << "Типичное использование:\n"
              << "std::cos(pi/3) = " << std::cos(pi / 3) << '\n'
              << "your cos(pi/3) = " << your_cos(pi / 3) << '\n'
              << "std::cos(pi/2) = " << std::cos(pi / 2) << '\n'
              << "your cos(pi/2) = " << your_cos(pi / 2) << '\n'
              << "std::cos(-3*pi/4) = " << std::cos(-3 * pi / 4) << '\n'
              << "your cos(-3*pi/4) = " << your_cos(-3 * pi / 4) << '\n'
              << "Специальные значения:\n"
              << "std::cos(+0) = " << std::cos(0.0) << '\n'
              << "std::cos(-0) = " << std::cos(-0.0) << '\n';
    // обработка ошибок
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "cos(INFINITY) = " << std::cos(INFINITY) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID поднят\n";
}

Возможный вывод:

Типичное использование:
std::cos(pi/3) = +0.5
your cos(pi/3) = +0.5
std::cos(pi/2) = +6.123233996e-17
your cos(pi/2) = -3.373452105e-15
std::cos(-3*pi/4) = -0.7071067812
your cos(-3*pi/4) = -0.7071067812
Специальные значения:
std::cos(+0) = +1
std::cos(-0) = +1
cos(INFINITY) = -nan
    FE_INVALID поднят

Смотрите также

(C++11) (C++11)
вычисляет синус ( sin(x) )
(функция)
(C++11) (C++11)
вычисляет тангенс ( tan(x) )
(функция)
(C++11) (C++11)
вычисляет арккосинус ( arccos(x) )
(функция)
вычисляет косинус комплексного числа ( cos(z) )
(шаблон функции)
применяет функцию std::cos к каждому элементу valarray
(шаблон функции)