std:: cos, std:: cosf, std:: cosl
|
Определено в заголовке
<cmath>
|
||
| (1) | ||
|
float
cos
(
float
num
)
;
double
cos
(
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
>
|
(S) | (начиная с C++26) |
|
Дополнительные перегрузки
(начиная с C++11)
|
||
|
Определено в заголовке
<cmath>
|
||
|
template
<
class
Integer
>
double cos ( Integer num ) ; |
(A) | (constexpr начиная с C++26) |
std::cos
для всех cv-неквалифицированных типов с плавающей запятой в качестве типа параметра.
(since C++23)
|
S)
SIMD перегрузка выполняет поэлементное вычисление
std::cos
для
v_num
.
|
(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
(шаблон функции) |
|
|
Документация C
для
cos
|
|