cacosh(3M)

DESCRIPTION

These functions are available only for Integrity servers.

cacosh() returns the complex arc hyperbolic cosine of z, in the range of a half-strip of non-negative values along the real axis and in the interval [-iPi,iPi] along the imaginary axis. There is a branch cut at values less than 1 along the real axis.

cacoshf() is a float complex version of cacosh(); it takes a float complex argument and returns a float complex result.

cacoshl() is a long double complex version of cacosh(); it takes a long double complex argument and returns a long double complex result.

cacoshw() is an extended complex version of cacosh(); it takes an extended complex argument and returns an extended complex result.

cacoshq() is equivalent to cacoshl() on HP-UX systems.

USAGE

To use these functions, compile with the default -Ae option. To use cacoshw() or cacoshq(), compile with the -fpwidetypes option. Make sure your program includes <complex.h>. Link in the math library by specifying -lm on the compiler or linker command line.

RETURN VALUE

cacosh(conj(z)) = conj(cacosh(z))

cacosh(±0+i0) returns +0+iPi/2.

cacosh(x+iInf) returns +Inf+iPi/2, for finite x.

cacosh(x+iNaN) returns NaN+iNaN and optionally raises the invalid floating-point exception, for finite x.

cacosh(-Inf+iy) returns +Inf+iPi, for positive-signed finite y.

cacosh(+Inf+iy) returns +Inf+i0, for positive-signed finite y.

cacosh(-Inf+iInf) returns +Inf+i3Pi/4.

cacosh(+Inf+iInf) returns +Inf+iPi/4.

cacosh(±Inf+iNaN) returns +Inf+iNaN.

cacosh(NaN+iy) returns NaN+iNaN and optionally raises the invalid floating-point exception, for finite y.

cacosh(NaN+iInf) returns +Inf+iNaN.

cacosh(NaN+iNaN) returns NaN+iNaN.

ERRORS

No errors are defined.

SEE ALSO

acosh(3M), ccosh(3M), complex(5).

STANDARDS CONFORMANCE

cacosh(), cacoshf(), cacoshl() : ISO/IEC C99 (including Annex G, ``IEC 60559-compatible complex arithmetic'')