计算双曲余弦值。
语法
double cosh( double x );
float coshf( float x );
long double coshl( long double x );
#define cosh(X) // Requires C11 or later
float cosh( float x ); // C++ only
long double cosh( long double x ); // C++ only
参数
x
角度(以弧度为单位)。
返回值
x 的双曲余弦值。
默认情况下,如果在 cosh、coshf 或 coshl 调用中的结果值过大,则函数返回 HUGE_VAL 并将 errno 设置为 ERANGE。
| 输入 | SEH 异常 | _matherr 异常 |
|---|---|---|
| ± QNaN, IND | 无 | _DOMAIN |
x ≥ 7.104760e+002 |
INEXACT+OVERFLOW |
OVERFLOW |
备注
由于 C++ 允许重载,因此你可以调用采用并返回 cosh 或 float 值的 long double 重载。 在 C 程序中,除非你使用 <tgmath.h> 宏来调用此函数,否则 cosh 始终采用并返回 double。
如果使用 <tgmath.h> 中的 cosh 宏,自变量的类型将确定选择哪个版本的函数。 有关详细信息,请参阅泛型类型数学。
默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态。
要求
| 例程 | 必需的标头 (C) | 必需的标头 (C++) |
|---|---|---|
| .- . | <math.h> |
<cmath> 或 <math.h> |
coshf 宏 |
<tgmath.h> |
有关兼容性的详细信息,请参阅 兼容性。
示例
请参阅 sinh、sinhf、sinhl 中的示例。