std::cosh, std::coshf, std::coshl

定义于头文件 `<cmath>`
	(1)
float cosh ( float num ); double cosh ( double num ); long double cosh ( long double num );			(直到 C++23)
/floating-point-type/ cosh ( /floating-point-type/ num );			(自 C++23 起) (constexpr 自 C++26 起)
float coshf( float num );		(2)	(自 C++11 起) (constexpr 自 C++26 起)
long double coshl( long double num );		(3)	(自 C++11 起) (constexpr 自 C++26 起)
SIMD 重载 (自 C++26 起)
定义于头文件 `<simd>`
template< /math-floating-point/ V > constexpr /deduced-simd-t/<V> cosh ( const V& v_num );		(S)	(自 C++26 起)
附加重载 (自 C++11 起)
定义于头文件 `<cmath>`
template< class Integer > double cosh ( Integer num );		(A)	(constexpr 自 C++26 起)

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

S) SIMD 重载对 v_num 执行元素级别的 std::cosh。

(有关定义，请参见 math-floating-point 和 deduced-simd-t。)

(自 C++26 起)

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

(自 C++11 起)

[编辑] 参数

num

-

浮点值或整数值

[编辑] 返回值

如果没有错误发生，则返回 num 的双曲余弦 (

cosh(num)

，或

e num +e -num 2

)。

如果发生由于溢出引起的范围错误，则返回 +HUGE_VAL、+HUGE_VALF 或 +HUGE_VALL。

[编辑] 错误处理

错误报告方式如 math_errhandling 中所指定。

如果实现支持 IEEE 浮点算术 (IEC 60559)，

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

[编辑] 注释

对于 IEEE 兼容的 double 类型，如果 $|num| > 710.5$ ，则 std::cosh(num) 会溢出。

附加重载不需要完全按照 (A) 的形式提供。它们只需要足以确保对于整数类型的参数 num，std::cosh(num) 具有与 std::cosh(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 << "cosh(1) = " << std::cosh(1) << '\n'
              << "cosh(-1) = " << std::cosh(-1) << '\n'
              << "log(sinh(" << x << ")+cosh(" << x << ")) = "
              << std::log(std::sinh(x) + std::cosh(x)) << '\n';
 
    // special values
    std::cout << "cosh(+0) = " << std::cosh(0.0) << '\n'
              << "cosh(-0) = " << std::cosh(-0.0) << '\n';
 
    // error handling
    errno=0;
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "cosh(710.5) = " << std::cosh(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";
}

可能的输出

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

[编辑] 参见

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

编译器支持
独立式和宿主式
语言
标准库
标准库头文件
命名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
诊断库
内存管理库
元编程库 (C++11)
通用工具库
容器库
迭代器库
范围库 (C++20)
算法库
字符串库
文本处理库
数值库
日期和时间库
输入/输出库
文件系统库 (C++17)
并发支持库 (C++11)
执行控制库 (C++26)
技术规范
符号索引
外部库

cppreference.cn

命名空间

变体

视图

操作