std:: sin, std:: sinf, std:: sinl
|
Определено в заголовочном файле
<cmath>
|
||
| (1) | ||
|
float
sin
(
float
num
)
;
double
sin
(
double
num
)
;
|
(до C++23) | |
|
/*floating-point-type*/
sin ( /*floating-point-type*/ num ) ; |
(начиная с C++23)
(constexpr начиная с C++26) |
|
|
float
sinf
(
float
num
)
;
|
(2) |
(начиная с C++11)
(constexpr начиная с C++26) |
|
long
double
sinl
(
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 sin ( Integer num ) ; |
(A) | (constexpr начиная с C++26) |
std::sin
для всех cv-неквалифицированных типов с плавающей запятой в качестве типа параметра.
(начиная с C++23)
|
S)
Перегрузка SIMD выполняет поэлементное вычисление
std::sin
для
v_num
.
|
(since C++26) |
|
A)
Дополнительные перегрузки предоставляются для всех целочисленных типов, которые трактуются как
double
.
|
(since C++11) |
Содержание |
Параметры
| num | - | значение с плавающей точкой или целое число, представляющее угол в радианах |
Возвращаемое значение
Если ошибок не возникает, возвращается синус
num
(
sin(num)
) в диапазоне
[
-
1
,
+
1
]
.
|
Результат может иметь незначительную или нулевую значимость, если величина num велика. |
(until C++11) |
Если происходит ошибка области определения, возвращается значение, определяемое реализацией (NaN, если поддерживается).
Если происходит ошибка диапазона из-за потери значимости (underflow), возвращается корректный результат (после округления).
Обработка ошибок
Ошибки сообщаются, как указано в math_errhandling .
Если реализация поддерживает арифметику с плавающей запятой IEEE (IEC 60559),
- если аргумент равен ±0, он возвращается без изменений.
- если аргумент равен ±∞, возвращается NaN и FE_INVALID устанавливается.
- если аргумент равен NaN, возвращается NaN.
Примечания
Случай, когда аргумент бесконечен, не указан как domain error в C (на что ссылается C++), но он определён как domain error в POSIX .
POSIX также указывает, что в случае потери значимости, num возвращается без изменений, и если это не поддерживается, возвращается определяемое реализацией значение, не превышающее DBL_MIN , FLT_MIN и LDBL_MIN .
Дополнительные перегрузки не обязаны быть предоставлены в точности как (A) . Они лишь должны быть достаточными для обеспечения того, чтобы для их аргумента num целочисленного типа, std :: sin ( num ) имел тот же эффект, что и std :: sin ( static_cast < double > ( num ) ) .
Пример
#include <cerrno> #include <cfenv> #include <cmath> #include <iomanip> #include <iostream> // #pragma STDC FENV_ACCESS ON const double pi = std::acos(-1); // or std::numbers::pi since C++20 constexpr double your_sin(double x) { double sin{0}, pow{x}; for (auto fac{1LLU}, n{1ULL}; n != 20; fac *= ++n, pow *= x) if (n & 1) sin += (n & 2 ? -pow : pow) / fac; return sin; } int main() { std::cout << std::setprecision(10) << std::showpos << "Типичное использование:\n" << "std::sin(pi/6) = " << std::sin(pi / 6) << '\n' << "your sin(pi/6) = " << your_sin(pi / 6) << '\n' << "std::sin(pi/2) = " << std::sin(pi / 2) << '\n' << "your sin(pi/2) = " << your_sin(pi / 2) << '\n' << "std::sin(-3*pi/4) = " << std::sin(-3 * pi / 4) << '\n' << "your sin(-3*pi/4) = " << your_sin(-3 * pi / 4) << '\n' << "Специальные значения:\n" << "std::sin(+0) = " << std::sin(0.0) << '\n' << "std::sin(-0) = " << std::sin(-0.0) << '\n'; // обработка ошибок std::feclearexcept(FE_ALL_EXCEPT); std::cout << "std::sin(INFINITY) = " << std::sin(INFINITY) << '\n'; if (std::fetestexcept(FE_INVALID)) std::cout << " FE_INVALID поднят\n"; }
Возможный вывод:
Типичное использование:
std::sin(pi/6) = +0.5
your sin(pi/6) = +0.5
std::sin(pi/2) = +1
your sin(pi/2) = +1
std::sin(-3*pi/4) = -0.7071067812
your sin(-3*pi/4) = -0.7071067812
Специальные значения:
std::sin(+0) = +0
std::sin(-0) = -0
std::sin(INFINITY) = -nan
FE_INVALID поднят
Смотрите также
|
(C++11)
(C++11)
|
вычисляет косинус (
cos(x)
)
(функция) |
|
(C++11)
(C++11)
|
вычисляет тангенс (
tan(x)
)
(функция) |
|
(C++11)
(C++11)
|
вычисляет арксинус (
arcsin(x)
)
(функция) |
|
вычисляет синус комплексного числа (
sin(z)
)
(шаблон функции) |
|
|
применяет функцию
std::sin
к каждому элементу valarray
(шаблон функции) |
|
|
Документация C
для
sin
|
|