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

Table of contents


NAME

cxcosf, cxcos, cxcosl, cxcosw, cxcosq, cxcosll, cxcosdf, cxcosd, cxcosdl, cxcosdll - complex 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 cxcosf (cx_float result, cx_float z);

extern void cxcos (cx_double result, cx_double z);

extern void cxcosl (cx_long_double result, cx_long_double z);

extern void cxcosw (cx_float80 result, cx_float80 z);

extern void cxcosq (cx_float128 result, cx_float128 z);

extern void cxcosll (cx_long_long_double result, cx_long_long_double z);

extern void cxcosdf (cx_decimal_float result, cx_decimal_float z);

extern void cxcosd (cx_decimal_double result, cx_decimal_double z);

extern void cxcosdl (cx_decimal_long_double result, cx_decimal_long_double z);

extern void cxcosdll (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 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 finite real-valued arguments, the real function range is [-1, +1].

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 [-1, +1]. For 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), cxatan(3CW), cxsin(3CW), cxtan(3CW).