std::tanh, std::tanhf, std::tanhl

定义在头文件中 `<cmath>`
	(1)
float tanh ( float num ); double tanh ( double num ); long double tanh ( long double num );			(直到 C++23)
/* 浮点类型 / tanh ( / 浮点类型 */ num );			(从 C++23 开始) (从 C++26 开始为 constexpr)
float tanhf( float num );		(2)	(从 C++11 开始) (从 C++26 开始为 constexpr)
long double tanhl( long double num );		(3)	(从 C++11 开始) (从 C++26 开始为 constexpr)
额外的重载 (从 C++11 开始)
定义在头文件中 `<cmath>`
template< class Integer > double tanh ( Integer num );		(A)	(从 C++26 开始为 constexpr)

1-3) 计算 num 的双曲正切。库为所有 cv-unqualified 浮点类型提供 std::tanh 的重载，作为参数的类型。(从 C++23 开始)

A) 为所有整数类型提供额外的重载，这些类型将被视为 double。

(从 C++11 开始)

[编辑] 参数

num

-

浮点或整数值

[编辑] 返回值

如果未发生错误，则返回 num 的双曲正切 (

tanh(num)

，或

e num -e -num e num +e -num

)。

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

[编辑] 错误处理

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

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

如果参数为 ±0，则返回 ±0。
如果参数为 ±∞，则返回 ±1。
如果参数为 NaN，则返回 NaN。

[编辑] 说明

POSIX 规定在下溢的情况下，num 将不作修改地返回，如果不支持该功能，则返回不超过 DBL_MIN、FLT_MIN 和 LDBL_MIN 的实现定义值。

额外的重载不需要完全按照 (A) 提供。它们只需要足以确保对于其整数类型的参数 num，std::tanh(num) 与 std::tanh(static_cast<double>(num)) 具有相同的效果。

[编辑] 示例

运行此代码

#include <cmath>
#include <iostream>
#include <random>
 
double get_random_between(double min, double max)
{
    std::random_device rd;
    std::mt19937 gen(rd());
    return std::uniform_real_distribution<>(min, max)(gen);
}
 
int main()
{
    const double x = get_random_between(-1.0, 1.0);
 
    std::cout << std::showpos
              << "tanh(+1) = " << std::tanh(+1) << '\n'
              << "tanh(-1) = " << std::tanh(-1) << '\n'
              << "tanh(x)*sinh(2*x)-cosh(2*x) = "
              << std::tanh(x) * std::sinh(2 * x) - std::cosh(2 * x) << '\n'
              // special values:
              << "tanh(+0) = " << std::tanh(+0.0) << '\n'
              << "tanh(-0) = " << std::tanh(-0.0) << '\n';
}

输出

tanh(+1) = +0.761594
tanh(-1) = -0.761594
tanh(x)*sinh(2*x)-cosh(2*x) = -1
tanh(+0) = +0
tanh(-0) = -0

[编辑] 参见

sinhsinhfsinhl (C++11)(C++11)	计算双曲正弦 (${\small\sinh{x}}$ $sinh(x)$ ) (函数) [编辑]
coshcoshfcoshl (C++11)(C++11)	计算双曲余弦 (${\small\cosh{x}}$ $cosh(x)$ ) (函数) [编辑]
atanhatanhfatanhl (C++11)(C++11)(C++11)	计算反双曲正切 (${\small\operatorname{artanh}{x}}$ $artanh(x)$ ) (函数) [编辑]
tanh(std::complex)	计算复数的双曲正切 (${\small\tanh{z}}$ $tanh(z)$ ) (函数模板) [编辑]
tanh(std::valarray)	将函数 std::tanh 应用于 valarray 的每个元素 (函数模板) [编辑]
C 文档 for tanh

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

cppreference.com

命名空间

变体

视图

操作