cacosh.3m (2010 09)

c
cacosh(3M) cacosh(3M)
(HP Integrity Server Only)
NAME
cacosh( ), cacoshf( ), cacoshl( ), cacoshw( ), cacoshq( ) - complex arc hyperbolic cosine functions
SYNOPSIS
#include <complex.h>
double complex cacosh(double complex z);
float complex cacoshf(float complex z);
long double complex cacoshl(long double complex z);
extended complex cacoshw(extended complex z);
quad complex cacoshq(quad complex z);
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 argu-
ment 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(), com-
pile 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).
HP-UX 11i Version 3: September 2010 1 Hewlett-Packard Company 1

Summary of content (2 pages)