std::sinh、std::sinhf、std::sinhl

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

1-3) 计算 num 的双曲正弦。该库为所有 cv 无限定浮点类型提供 std::sinh 的重载，作为参数类型。 (自 C++23)

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

(自 C++11)

[编辑] 参数

num

-

浮点数或整数值

[编辑] 返回值

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

sinh(num)

，或

e num -e -num 2

)。

如果发生由于溢出导致的范围错误，则返回 ±HUGE_VAL、±HUGE_VALF 或 ±HUGE_VALL。

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

[编辑] 错误处理

错误报告如 math_errhandling 中所述。

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

如果参数为 ±0 或 ±∞，则按原样返回。
如果参数为 NaN，则返回 NaN。

[编辑] 备注

POSIX 规定，在发生下溢的情况下，按原样返回 num，如果该操作不受支持，则返回小于等于 DBL_MIN、FLT_MIN 和 LDBL_MIN 的实现定义值。

附加重载不必以 (A) 的方式提供。它们只需要足够多，以确保对于整数类型的参数 num，std::sinh(num) 与 std::sinh(static_cast<double>(num)) 具有相同的效果。

[编辑] 示例

运行此代码

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
 
int main()
{
    const double x = 42;
 
    std::cout << "sinh(1) = " << std::sinh(1) << '\n'
              << "sinh(-1) = " << std::sinh(-1) << '\n'
              << "log(sinh(" << x << ")+cosh(" << x << ")) = "
              << std::log(std::sinh(x) + std::cosh(x)) << '\n';
 
    // special values
    std::cout << "sinh(+0) = " << std::sinh(0.0) << '\n'
              << "sinh(-0) = " << std::sinh(-0.0) << '\n';
 
    // error handling
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "sinh(710.5) = " << std::sinh(710.5) << '\n';
 
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_OVERFLOW))
        std::cout << "    FE_OVERFLOW raised\n";
}

输出

sinh(1) = 1.1752
sinh(-1) = -1.1752
log(sinh(42)+cosh(42)) = 42
sinh(+0) = 0
sinh(-0) = -0
sinh(710.5) = inf
    errno == ERANGE: Numerical result out of range
    FE_OVERFLOW raised

[编辑] 另请参阅

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

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

cppreference.com

命名空间

变体

视图

操作