complex(3C)

NAME
     complex - Introduction to C++ complex mathematics library

SYNOPSIS
     #include <complex.h>
     class complex;

DESCRIPTION
     NOTE: This man page applies only to the -o32 ABI.  The MIPSpro -n32
     and -64 ABIs support the template-based complex class which is
     included in the C++ standard library and is automatically loaded by
     the MIPSpro C++ compiler.  The -lm option must still be used to link
     the math library.

     This section describes functions and operators found in the C++
     Complex Mathematics Library, libcomplex.a.  These functions are not
     automatically loaded by the C++ compiler, CC(1); however, the link
     editor searches this library under the -lcomplex option.  Declarations
     for these functions may be found in the <complex.h> #include file.
     When compiling programs using the complex library, users must provide
     the -lm options on the CC command line to link the math library.

     The Complex Mathematics library implements the data type of complex
     numbers as a class, complex.  It overloads the standard input, output,
     arithmetic, assignment, and comparison operators, discussed in the
     manual pages for cplxops(3C).  It also overloads the standard
     exponential, logarithm, power, and square root functions, discussed in
     cplxexp(3C), and the trigonometric functions of sine, cosine,
     hyperbolic sine, and hyperbolic cosine, discussed in cplxtrig(3C), for
     the class complex.  Routines for converting between Cartesian and
     polar coordinate systems are discussed in cartpol(3C).  Error handling
     is described in cplxerr(3C).

RETURN VALUES
     Functions in the Complex Mathematics Library may return the
     conventional values (0, 0), (0, _HUGE), (_HUGE, 0), or (_HUGE, _HUGE),
     when the function is undefined for the given arguments or when the
     value is not representable.

     HUGE is the largest-magnitude single-precision floating-point number
     and is defined in the file <math.h>.  The header file <math.h> is
     included in the file <complex.h>.

     In these cases, the external variable errno (see intro(2)) is set to
     the value EDOM or ERANGE.

FILES
     INCDIR/complex.h
     LIBDIR/libcomplex.a

SEE ALSO
     cartpol(3C), cplxerr(3C), cplxops(3C), cplxexp(3C), cplxtrig(3C)