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

在标头 `<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 起) (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 在范围 $[-1 ; +1]$ 中的正弦（ $sin(num)$ ）。

如果 num 的绝对值很大，那么结果可能拥有少量或完全没有有效数字。

(C++11 前)

如果发生定义域错误，那么返回值由实现定义（在受支持的平台上是 NaN）。

如果发生下溢导致的值域错误，那么返回（舍入后的）正确结果。

错误处理

报告 math_errhandling 中指定的错误。

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

如果实参是 ±0，那么返回不修改的该值
如果实参是 ±∞，那么返回 NaN 并引发 FE_INVALID
如果实参是 NaN，那么返回 NaN

注解

实参为无穷大的情况不被指定为（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); // C++20 起也可用 std::numbers::pi
 
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

参阅

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)	对 `valarray` 的每个元素应用 std::sin 函数 (函数模板)

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库

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)	对 `valarray` 的每个元素应用 std::sin 函数 (函数模板)

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

参数

返回值

错误处理

注解

示例

参阅

导航