[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

ERROR HANDLING (PHCL,WSCL,STCL,ARCL)

Purpose

Either the graPHIGS API supplies the Error Handling function by default, or the application supplies the function. The graPHIGS API calls the Error Handling subroutine function whenever the graPHIGS API detects an error. The default or standard Error Handling function calls the Error Logging function with the same parameters. An application supplied error handling function, which accepts the same arguments as the default error handler, may also call the Error Logging function.

See the Open PHIGS subroutine for error file specification for each supported binding. See Chapter 21. "Implementation Errors and graPHIGS API Messages for ISO PHIGS-Defined Errors" for details on implementation errors and ISO PHIGS defined errors.

Users of the FORTRAN binding may replace the default error handling subroutine with a user supplied subroutine of the same name, PERHND. C binding users may use the Set Error Handling subroutine to install a user supplied error handling function during execution time.

Language Bindings

C

perr_hand (error_num, func_num, error_file)

Input Parameters

Pint error_num
Error number.

Pint func_num
Identifier of function that detected the error (see Chapter 17. ISO PHIGS C Type and Macro Definitions reference #1).

const char *error_file
Name of the error file.

FORTRAN

PERHND (errnr, fctid, errfil)

Input Parameters

integer errnr
Error number.

integer fctid
Function identification (see Chapter 18. ISO PHIGS FORTRAN Enumeration Types.

integer errfil
Error file.

Errors

None

Related Subroutines

  • Emergency Close PHIGS

  • Error Logging

  • Open PHIGS

  • Set Error Handling

  • Set Error Handling Mode


  • [ Previous | Next | Contents | Glossary | Home | Search ]