NAME

gerr_procedure − control graphics error handling

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 Pointer to the user-supplied procedure to be called when an error is detected.  If proc is null, the default procedure is called. 

print_gerr Integer value that determines whether or not to print errors and/or warnings. 

errnumber Error number

Discussion

Gerr_procedure is used to specify a user-supplied procedure to be called when an error is detected. If a null pointer is passed, the default Starbase system error procedure is called.  For systems that cannot pass a null procedure pointer, the gerr_defaults procedure is provided to reinstate the conditions listed under DEFAULTS. 

Gerr_message returns the text of an error message that can contain up to 80 characters.  Gerr_print_control controls error mesage printing. 

Print_gerr can have any of the following values:

NO_ERROR_PRINTING
PRINT_ERRORS
PRINT_WARNINGS

These values can be ORed together in 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.) 

SEE ALSO

inquire_gerror(3G). 

Hewlett-Packard Company  —  May 11, 2021