CXACOSH 3CW "12 August 2009" "mathcw-1.00"

Table of contents


NAME

cxacoshf, cxacosh, cxacoshl, cxacoshw, cxacoshq, cxacoshll, cxacoshdf, cxacoshd, cxacoshdl, cxacoshdll - complex inverse hyperbolic cosine function with real arithmetic

SYNOPSIS

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

#include <mathcw.h>

#include <cxcw.h>

extern void cxacoshf (cx_float result, cx_float z);

extern void cxacosh (cx_double result, cx_double z);

extern void cxacoshl (cx_long_double result, cx_long_double z);

extern void cxacoshw (cx_float80 result, cx_float80 z);

extern void cxacoshq (cx_float128 result, cx_float128 z);

extern void cxacoshll (cx_long_long_double result, cx_long_long_double z);

extern void cxacoshdf (cx_decimal_float result, cx_decimal_float z);

extern void cxacoshd (cx_decimal_double result, cx_decimal_double z);

extern void cxacoshdl (cx_decimal_long_double result, cx_decimal_long_double z);

extern void cxacoshdll (cx_decimal_long_long_double result, cx_decimal_long_long_double 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 (a two-element array with the real and imaginary parts in that order). 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.

The cx family of functions provide limited support for complex arithmetic when compiler or language support for a complex type is lacking.


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

cxasinh(3CW), cxatanh(3CW), cxcosh(3CW), cxsinh(3CW), cxtanh(3CW).