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

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: HP

DESCRIPTION

INPUT PARAMETERS

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

print_gerr is an integer value which determines if errors and/or warnings or neither are to be printed.

errnumber is an error number

DISCUSSION

Gerr_control is used to specify a user-supplied procedure to be called when an error is detected. 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 values for print_gerr are:

     NO_ERROR_PRINTING
     PRINT_ERRORS
     PRINT_WARNINGS

and may be or’ed together for desired combinations.

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