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 then 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 OR’ed for 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, then 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 re-instates 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 OR’ed together to produce the desired messages. If NO_ERROR_PRINTNG is OR’ed 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

Related Articles