std::tan、std::tanf、std::tanl

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

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

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

(自 C++11 起)

[编辑] 参数

num

-

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

[编辑] 返回值

如果没有错误发生，将返回 num 的正切 ( $tan(num)$ )。

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

(直到 C++11)

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

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

[编辑] 错误处理

错误的报告方式如 math_errhandling 中所述。

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

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

[编辑] 注释

参数为无穷大时的情况在 C（C++ 向其 defer）中未指定为域错误，但在 POSIX 中被定义为域错误。

该函数在 $π(1/2 + n)$ 处具有数学极点；但是，没有常见的浮点表示能够精确地表示 π/2，因此没有参数值会发生极点错误。

其他重载不需要精确地以 (A) 方式提供。它们只需要足够确保对于整数类型的参数 num，std::tan(num) 与 std::tan(static_cast<double>(num)) 的效果相同。

[编辑] 示例

运行此代码

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <iostream>
 
// #pragma STDC FENV_ACCESS ON
const double pi = std::acos(-1); // or C++20's std::numbers::pi
 
int main()
{
    // typical usage
    std::cout << "tan(1*pi/4) = " << std::tan(1*pi/4) << '\n' // 45°
              << "tan(3*pi/4) = " << std::tan(3*pi/4) << '\n' // 135°
              << "tan(5*pi/4) = " << std::tan(5*pi/4) << '\n' // -135°
              << "tan(7*pi/4) = " << std::tan(7*pi/4) << '\n'; // -45°
 
    // special values
    std::cout << "tan(+0) = " << std::tan(0.0) << '\n'
              << "tan(-0) = " << std::tan(-0.0) << '\n';
 
    // error handling
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "tan(INFINITY) = " << std::tan(INFINITY) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised\n";
}

可能的输出

tan(1*pi/4) = 1
tan(3*pi/4) = -1
tan(5*pi/4) = 1
tan(7*pi/4) = -1
tan(+0) = 0
tan(-0) = -0
tan(INFINITY) = -nan
    FE_INVALID raised

[编辑] 参见

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

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

cppreference.com

命名空间

变体

视图

操作