complex(3C)

NAME
     complex - Introduction to C++ complex mathematics library

SYNOPSIS
     #include <complex.h>
     class complex;

IMPLEMENTATION
     IRIX systems (-o32 ABI only)

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).

DIAGNOSTICS
     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)

     Stroustrup, B., ``Complex Arithmetic in C++,'' Chapter 1 of the C++
     Language System Release 2.1 Library Manual

     This man page is available only online.