Namespaces
Variants

std:: sin, std:: sinf, std:: sinl

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 sin ( float num ) ;

double sin ( double num ) ;

long double sin ( long 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 >

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