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

Table of contents


NAME

cacosf, cacos, cacosl, cacosw, cacosq, cacosll, cacosdf, cacosd, cacosdl, cacosdll - complex arc 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 cacosf (float complex z);

extern double complex cacos (double complex z);

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

extern __float80 complex cacosw (__float80 complex z);

extern __float128 complex cacosq (__float128 complex z);

extern long_long_double complex cacosll (long_long_double complex z);

extern decimal_float complex cacosdf (decimal_float complex z);

extern decimal_double complex cacosd (decimal_double complex z);

extern decimal_long_double complex cacosdl (decimal_long_double complex z);

extern decimal_long_long_double complex cacosdll (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 arc cosine function.

The value of the complex argument z is unrestricted.

For real-valued arguments in the range [-1,+1], the real function range is [pi,0].

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,+pi]. 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

casin(3CW), catan(3CW), ccos(3CW), csin(3CW), ctan(3CW).