complex_error(3C++)

Synopsis

   #include <complex.h>
   class c_exception
   {
   	int	type;
   	char	*name;
   	complex	arg1;
   	complex	arg2;
   	complex	retval;
   

   public:
   

   	c_exception( char *n, const complex& a1,
   		     const complex& a2 = complex_zero ) throw();
   

   	friend int	complex_error( c_exception& );
   

   	friend complex	exp( complex );
   	friend complex	sinh( complex );
   	friend complex	cosh( complex );
   	friend complex	log( complex );   
   };

Description

i = complex_error(x)

Invoked by functions in the C++ Complex Mathematics Library when errors are detected.

Users may define their own procedures for handling errors, by defining a function named complex_error in their programs. complex_error must be of the form described above. complex_error is permitted to throw an exception.

The element type is an integer describing the type of error that has occurred, from the following list of constants (defined in the header file):

SING argument singularity
OVERFLOW overflow range error
UNDERFLOW underflow range error

The element name points to a string containing the name of the function that incurred the error. The variables arg1 and arg2 are the arguments with which the function was invoked. retval is set to the default value that will be returned by the function unless the user's complex_error sets it to a different value.

If the user's complex_error function returns non-zero, no error message will be printed, and errno will not be set.

If complex_error is not supplied by the user, the default error-handling procedures, described with the complex math functions involved, will be invoked upon error. These procedures are also summarized in the table below. In every case, errno is set to EDOM or ERANGE and the program continues.

Note that complex math functions call functions included in the math library which has its own error handling routine, matherr(3M). Users may also override this routine by supplying their own version.

DEFAULT ERROR HANDLING PROCEDURES
	Types of Errors
type	SING	OVERFLOW	UNDERFLOW
errno	EDOM	ERANGE	ERANGE
EXP:
real too large/small	-	(±H, ±H)	(0, 0)
imag too large	-	(0, 0)	-
LOG:
arg = (0, 0)	M, (H, 0)	-	-
SINH:
real too large	-	(±H, ±H)	-
imag too large	-	(0, 0)	-
COSH:
real too large	-	(±H, ±H)	-
imag too large	-	(0, 0)	-

 DEFAULT ERROR HANDLING|PROCEDURES
                       | Types of Er|rors        |
 type                  | SING       | OVERFLOW  | UNDERFLOW
 errno                 | EDOM       | ERANGE    | ERANGE
 EXP:                  |            |           |
  real too large/small | -          | (±H, ±H)  | (0, 0)
  imag too large       | -          | (0, 0)    | -
 LOG:                  |            |           |
  arg = (0, 0)         | M, (H, 0)  | -         | -
 SINH:                 |            |           |
  real too large       | -          | (±H, ±H)  | -
  imag too large       | -          | (0, 0)    | -
 COSH:                 |            |           |
  real too large       | -          | (±H, ±H)  | -
  imag too large       | -          | (0, 0)    | -

ABBREVIATIONS
M	Message is printed (EDOM error).
(H, 0)	(HUGE, 0) is returned.
(±H, ±H)	(±HUGE, ±HUGE) is returned.
(0, 0)	(0, 0) is returned.

 ABBREVIATIONS
  M          Message is printed (EDOM error).
  (H, 0)     (HUGE, 0) is returned.
  (±H, ±H)   (±HUGE, ±HUGE) is returned.
  (0, 0)     (0, 0) is returned.

References