Namespaces
Variants

ccoshf, ccosh, ccoshl

From cppreference.net
C
Numerics
Complex number arithmetic
Types and the imaginary constant
Manipulation
(C99)
(C99)
(C99)
(C99)
(C99)
(C99)
Power and exponential functions
(C99)
(C99)
(C99)
(C99)
Trigonometric functions
(C99)
(C99)
(C99)
(C99)
(C99)
(C99)
Hyperbolic functions
ccosh
(C99)
(C99)
(C99)
(C99)
(C99)
(C99)
定义于头文件 <complex.h>
float complex ccoshf ( float complex z ) ;
(1) (C99 起)
double complex ccosh ( double complex z ) ;
(2) (C99 起)
long double complex ccoshl ( long double complex z ) ;
(3) (C99 起)
定义于头文件 <tgmath.h>
#define cosh( z )
(4) (C99 起)
1-3) 计算 z 的复双曲余弦值。
4) 类型泛型宏：若 z 具有类型 long double complex ，则调用 ccoshl ；若 z 具有类型 double complex ，则调用 ccosh ；若 z 具有类型 float complex ，则调用 ccoshf 。若 z 为实数或整数，则该宏调用对应的实数函数（ coshf 、 cosh 、 coshl ）。若 z 为虚数，则该宏调用函数 cos 的对应实数版本，实现公式 cosh(iy) = cos(y) ，且返回类型为实数。

目录

参数

z - 复参数

返回值

如果没有错误发生，则返回复数 z 的双曲余弦值

错误处理与特殊值

错误报告方式与 math_errhandling 保持一致

如果实现支持 IEEE 浮点运算，

  • ccosh ( conj ( z ) ) == conj ( ccosh ( z ) )
  • ccosh ( z ) == ccosh ( - z )
  • 若 z 为 +0+0i ，结果为 1+0i
  • 若 z 为 +0+∞i ，结果为 NaN±0i （虚部符号未指定）并引发 FE_INVALID
  • 若 z 为 +0+NaNi ，结果为 NaN±0i （虚部符号未指定）
  • 若 z 为 x+∞i （对于任意有限非零 x），结果为 NaN+NaNi 并引发 FE_INVALID
  • 若 z 为 x+NaNi （对于任意有限非零 x），结果为 NaN+NaNi 且可能引发 FE_INVALID
  • 若 z 为 +∞+0i ，结果为 +∞+0i
  • 若 z 为 +∞+yi （对于任意有限非零 y），结果为 +∞cis(y)
  • 若 z 为 +∞+∞i ，结果为 ±∞+NaNi （实部符号未指定）并引发 FE_INVALID
  • 若 z 为 +∞+NaN ，结果为 +∞+NaN
  • 若 z 为 NaN+0i ，结果为 NaN±0i （虚部符号未指定）
  • 若 z 为 NaN+yi （对于任意有限非零 y），结果为 NaN+NaNi 且可能引发 FE_INVALID
  • 若 z 为 NaN+NaNi ，结果为 NaN+NaNi

其中 cis(y) 表示 cos(y) + i sin(y)

注释

Mathematical definition of hyperbolic cosine is 双曲余弦 z =
e z
+e -z
2

双曲余弦是复平面上的整函数且无分支切割。它关于虚部具有周期性，周期为 2πi

示例

运行此代码 
#include <stdio.h>
#include <math.h>
#include <complex.h>
int main(void)
{
    double complex z = ccosh(1);  // 沿实轴表现如实双曲余弦函数
    printf("cosh(1+0i) = %f%+fi (cosh(1)=%f)\n", creal(z), cimag(z), cosh(1));
    double complex z2 = ccosh(I); // 沿虚轴表现如实余弦函数
    printf("cosh(0+1i) = %f%+fi ( cos(1)=%f)\n", creal(z2), cimag(z2), cos(1));
}

输出： 

cosh(1+0i) = 1.543081+0.000000i (cosh(1)=1.543081)
cosh(0+1i) = 0.540302+0.000000i ( cos(1)=0.540302)

参考文献

  • C11 标准 (ISO/IEC 9899:2011):
  • 7.3.6.4 ccosh 函数 (p: 193)
  • 7.25 泛型数学 <tgmath.h> (p: 373-375)
  • G.6.2.4 ccosh 函数 (p: 541)
  • G.7 泛型数学 <tgmath.h> (p: 545)
  • C99 标准 (ISO/IEC 9899:1999):
  • 7.3.6.4 ccosh 函数 (p: 175)
  • 7.22 泛型数学 <tgmath.h> (p: 335-337)
  • G.6.2.4 ccosh 函数 (p: 476)
  • G.7 泛型数学 <tgmath.h> (p: 480)

参考

(C99) (C99) (C99)
计算复双曲正弦
(函数)
(C99) (C99) (C99)
计算复双曲正切
(函数)
(C99) (C99) (C99)
计算复反双曲余弦
(函数)
(C99) (C99)
计算双曲余弦 ( cosh(x) )
(函数)
C++ 文档 for cosh