ccosh

Compute the hyperbolic cosine of a complex number.

Interface Definition

C interface:

float complex ccoshf(float complex x);

double complex ccosh(double complex x);

Parameters

Parameter	Type	Description	Input/Output
x	For ccoshf, x is of complex single-precision floating-point type. For ccosh, x is of complex double-precision floating-point type.	Floating-point value of the input data.	Input

Return Value

The hyperbolic cosine y of x is returned.

The special values are listed in the following table.

Real Part of the Input (x.real)	Imaginary Part of the Input (x.imag)	Real Part of the Output (y.real)	Imaginary Part of the Output (y.imag)
0.0	0.0	0.0	0.0
0.0	-0.0	0.0	-0.0
0.0	inf	0.0	NaN
0.0	-inf	0.0	NaN
0.0	NaN	0.0	NaN
0.0	–NaN	0.0	–NaN
-0.0	0.0	-0.0	0.0
-0.0	-0.0	-0.0	-0.0
-0.0	inf	-0.0	NaN
-0.0	-inf	-0.0	NaN
-0.0	NaN	-0.0	NaN
-0.0	–NaN	-0.0	–NaN
inf	0.0	inf	0.0
inf	-0.0	inf	-0.0
inf	inf	inf	NaN
inf	-inf	inf	NaN
inf	NaN	inf	NaN
inf	–NaN	inf	–NaN
-inf	0.0	-inf	0.0
-inf	-0.0	-inf	-0.0
-inf	inf	-inf	NaN
-inf	-inf	-inf	NaN
-inf	NaN	-inf	NaN
-inf	–NaN	-inf	–NaN
NaN	0.0	NaN	0.0
NaN	-0.0	NaN	-0.0
NaN	inf	NaN	NaN
NaN	-inf	NaN	NaN
NaN	NaN	NaN	NaN
NaN	–NaN	NaN	–NaN
–NaN	0.0	–NaN	0.0
–NaN	-0.0	–NaN	-0.0
–NaN	inf	–NaN	NaN
–NaN	-inf	–NaN	NaN
–NaN	NaN	–NaN	NaN
–NaN	–NaN	–NaN	–NaN

Dependency

C: "kc.h"

Example

C interface:

    // typical usage
    double x1 = INFINITY, y1 = INFINITY;
    double x2 = 2.0, y2 = 3.0;
    double x3 = -2.5, y3 = -3.4;
    double x4 = NAN, y4 = NAN;
    double x5 = 0, y5 = 0;
    double complex z1 = ccosh(__builtin_complex(x1, y1));
    double complex z2 = ccosh(__builtin_complex(x2, y2));
    double complex z3 = ccosh(__builtin_complex(x3, y3));
    double complex z4 = ccosh(__builtin_complex(x4, y4));
    double complex z5 = ccosh(__builtin_complex(x5, y5));
    // print result
    printf("/*\n");
    printf(" * ccosh(%.2f + %.2f*I) = %.6f + %.6f*I\n", x1, y1, __real__(z1), __imag__(z1));
    printf(" * ccosh(%.2f + %.2f*I) = %.6f + %.6f*I\n", x2, y2, __real__(z2), __imag__(z2));
    printf(" * ccosh(%.2f + %.2f*I) = %.6f + %.6f*I\n", x3, y3, __real__(z3), __imag__(z3));
    printf(" * ccosh(%.2f + %.2f*I) = %.6f + %.6f*I\n", x4, y4, __real__(z4), __imag__(z4));
    printf(" * ccosh(%.2f + %.2f*I) = %.6f + %.6f*I\n", x5, y5, __real__(z5), __imag__(z5));
    printf(" **/\n");
 
   /*
    * ccosh(inf + inf*I) = inf + nan*I
    * ccosh(2.00 + 3.00*I) = -3.724546 + 0.511823*I
    * ccosh(-2.50 + -3.40*I) = -5.928686 + -1.546076*I
    * ccosh(nan + nan*I) = nan + nan*I
    * ccosh(0.00 + 0.00*I) = 1.000000 + 0.000000*I
    **/

Parent topic: Complex Functions