CPLX.INTRO(3C++)					      CPLX.INTRO(3C++)

NAME    [Toc]    [Back]

     complex - introduction to C++ complex mathematics library

SYNOPSIS    [Toc]    [Back]

     #include <complex.h>
     class     complex;

DESCRIPTION    [Toc]    [Back]

     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 #include file <complex.h>.	 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++).

FILES    [Toc]    [Back]

     INCDIR/complex.h
     LIBDIR/libcomplex.a

SEE ALSO    [Toc]    [Back]

     cartpol(3C++), cplxerr(3C++), cplxops(3C++), cplxexp(3C++), and
     cplxtrig(3C++).
     Stroustrup, B., ``Complex Arithmetic in C++,'' Chapter 1 of the C++
     Language System Release 2.1 Library Manual.

DIAGNOSTICS    [Toc]    [Back]

     Functions in the Complex Mathematics Library (3C++) 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.


									PPPPaaaaggggeeee 1111