gerr_control(3G)

NAME

gerr_control − control the handling of a graphics error.

SYNOPSIS

C Syntax

void gerr_procedure ( proc );
void ( *proc )();

void gerr_defaults ();

void gerr_print_control ( print_gerr )
int print_gerr;

char *gerr_message ( errnumber );
int errnumber;

FORTRAN77 Syntax

subroutine gerr_procedure ( proc )
integer*4 function proc

subroutine gerr_defaults ()

subroutine gerr_print_control ( print_gerr )
integer*4 print_gerr

subroutine gerr_message ( errnumber, mesg )
character*(*) mesg
integer*4 errnumber

PASCAL Syntax

procedure gerr_procedure ( procedure proc );

procedure gerr_defaults ();

procedure gerr_print_control ( print_gerr:integer );

procedure gerr_message ( errnumber:integer; var mesg:string );

DESCRIPTION

INPUT PARAMETERS

proc A pointer to the user supplied procedure to be called when an error is detected. If proc is null, the default procedure will be called.

print_gerr An integer value which specifies if errors and/or warnings or neither are to be printed. The following constants are used for values of print_gerr. These values can be ORed together for desired results:

NO_ERROR_PRINTING - disables error printing.
PRINT_ERRORS - enables error printing.
PRINT_WARNINGS - enables printing of warnings.

errnumber The error number.

DISCUSSION

Gerr_control is used to specify a user-supplied error handling procedure. If a null pointer is passed, the Starbase system procedure will be called. For systems which find it difficult (or impossible) to pass a null procedure pointer, the gerr_defaults procedure is provided which reinstates the default conditions listed below.

Gerr_message returns the text of an error message. The maximum length of a message is 80 characters. The control of error message printing is handled by the gerr_print_control procedure.

The print_gerr constants can be ORed together to produce the desired messages. If NO_ERROR_PRINTNG is ORed with PRINT_ERRORS, no errors will be printed.

DEFAULTS

The Starbase system error procedure is called when an error is detected.
Print_gerr = PRINT_ERRORS (only errors are printed, warnings are not printed.)

Museum