CACOSH 3CW "11 August 2009" "mathcw-1.00"

Table of contents


NAME

cacoshf, cacosh, cacoshl, cacoshw, cacoshq, cacoshll, cacoshdf, cacoshd, cacoshdl, cacoshdll - complex inverse hyperbolic cosine function

SYNOPSIS

cc [ flags ] -I/usr/local/include file(s) -L/usr/local/lib -lmcw [ ... ]

#include <mathcw.h>

#include <complexcw.h>

extern float complex cacoshf (float complex z);

extern double complex cacosh (double complex z);

extern long double complex cacoshl (long double complex z);

extern __float80 complex cacoshw (__float80 complex z);

extern __float128 complex cacoshq (__float128 complex z);

extern long_long_double complex cacoshll (long_long_double complex z);

extern decimal_float complex cacoshdf (decimal_float complex z);

extern decimal_double complex cacoshd (decimal_double complex z);

extern decimal_long_double complex cacoshdl (decimal_long_double complex z);

extern decimal_long_long_double complex cacoshdll (decimal_long_long_double complex z);

NB: Functions with prototypes containing underscores in type names may be available only with certain extended compilers.


DESCRIPTION

Compute the principal value of the complex inverse hyperbolic cosine function.

The value of the complex argument z is unrestricted.

For real-valued arguments in the range [1, Infinity], the real function range is [+0, +Infinity], and Infinity is only possible if z is Infinity.

When compiler support for complex types is lacking, consider using the cx family of functions instead.


BRANCH CUTS

To be written.

RETURN VALUES

For in-range real arguments, the returned value is in the range [+0, +Infinity]. For other finite real or finite complex arguments, the returned value is complex and finite. For infinite arguments, at least one component of the returned value is Infinity. Otherwise, for NaN arguments, at least one component of the returned value is a quiet NaN.

ERRORS

For out-of-range, Infinity and NaN arguments, the returned value is a quiet NaN, and errno is set to EDOM.

SEE ALSO

casinh(3CW), catanh(3CW), ccosh(3CW), csinh(3CW), ctanh(3CW).