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

Table of contents


NAME

cxatanf, cxatan, cxatanl, cxatanw, cxatanq, cxatanll, cxatandf, cxatand, cxatandl, cxatandll - complex arc tangent 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 cxatanf (cx_float result, cx_float z);

extern void cxatan (cx_double result, cx_double z);

extern void cxatanl (cx_long_double result, cx_long_double z);

extern void cxatanw (cx_float80 result, cx_float80 z);

extern void cxatanq (cx_float128 result, cx_float128 z);

extern void cxatanll (cx_long_long_double result, cx_long_long_double z);

extern void cxatandf (cx_decimal_float result, cx_decimal_float z);

extern void cxatand (cx_decimal_double result, cx_decimal_double z);

extern void cxatandl (cx_decimal_long_double result, cx_decimal_long_double z);

extern void cxatandll (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 arc tangent 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 [-Infinity,+Infinity], the real function range is [-pi/2,+pi/2].

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

cxacos(3CW), cxasin(3CW), cxcos(3CW), cxsin(3CW), cxtan(3CW).