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

在头文件 `<cmath>` 中定义
	(1)
float sin ( float num ); double sin ( double num ); long double sin ( long double num );			(直到 C++23)
/* 浮点类型 / sin ( / 浮点类型 */ num );			(自 C++23 起) (自 C++26 起为 constexpr)
float sinf( float num );		(2)	(自 C++11 起) (自 C++26 起为 constexpr)
long double sinl( long double num );		(3)	(自 C++11 起) (自 C++26 起为 constexpr)
其他重载 (自 C++11 起)
在头文件 `<cmath>` 中定义
template< class Integer > double sin ( Integer num );		(A)	(自 C++26 起为 constexpr)

1-3) 计算 num 的正弦值（以弧度为单位）。库为所有 cv 无限定浮点类型提供 std::sin 的重载，作为参数的类型。(自 C++23 起)

A) 为所有整数类型提供其他重载，这些类型被视为 double.

(自 C++11 起)

[编辑] 参数

num

-

表示以弧度为单位的角度的浮点或整数类型的值

[编辑] 返回值

如果未发生错误，则返回 num 的正弦值 ( $sin(num)$ )，范围为 [-1, +1]。

如果 num 的大小很大，则结果可能几乎没有意义。

(直到 C++11)

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

如果由于下溢而发生范围错误，则返回正确的结果（经过舍入）。

[编辑] 错误处理

错误报告如 math_errhandling 中所述。

如果实现支持 IEEE 浮点算术（IEC 60559），则

如果参数为 ±0，则返回未修改的参数。
如果参数为 ±∞，则返回 NaN，并引发 FE_INVALID。
如果参数为 NaN，则返回 NaN。

[编辑] 说明

参数为无穷大时的情况在 C（C++ 遵循 C）中未指定为域错误，但在 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
              << "Typical usage:\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'
              << "Special values:\n"
              << "std::sin(+0) = " << std::sin(0.0) << '\n'
              << "std::sin(-0) = " << std::sin(-0.0) << '\n';
 
    // error handling
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "std::sin(INFINITY) = " << std::sin(INFINITY) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised\n";
}

可能的输出

Typical usage:
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
Special values:
std::sin(+0) = +0
std::sin(-0) = -0
std::sin(INFINITY) = -nan
    FE_INVALID raised

[编辑] 另请参见

coscosfcosl (C++11)(C++11)	计算余弦 (${\small\cos{x}}$ $cos(x)$ ) (函数) [编辑]
tantanftanl (C++11)(C++11)	计算正切 (${\small\tan{x}}$ $tan(x)$ ) (函数) [编辑]
asinasinfasinl (C++11)(C++11)	计算反正弦 (${\small\arcsin{x}}$ $arcsin(x)$ ) (函数) [编辑]
sin(std::complex)	计算复数的正弦 (${\small\sin{z}}$ $sin(z)$ ) (函数模板) [编辑]
sin(std::valarray)	将函数 std::sin 应用于 valarray 的每个元素 (函数模板) [编辑]
C 文档 for sin

编译器支持
独立和托管
语言
标准库
标准库头文件
命名需求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作