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

SET ERROR HANDLING (PHCL,WSCL,STCL,ARCL)

Purpose

Use Set Error Handling to set the PHIGS error handling function to the specified new error handling function. The graPHIGS API returns the previous error handling function on this call.

The graPHIGS API gives control to this application specified routine when the graPHIGS API detects an error. The application defined error handler must accept the same arguments as the standard error handler, perr_hand. Refer to perr_hand for a description of those arguments. If your application has not defined an error handler, then the graPHIGS API uses the default, perr_hand, which logs an error in the file specified by the first parameter of the Open PHIGS subroutine ( ). An application defined error handler may invoke Inquiry subroutines ( ) and the Error Logging subroutine

Note:

This subroutines is defined only for the C binding.

Language Binding

C

pset_err_hand (new_err_hand, old_err_hand)

Input Parameters

void (*new_err_hand) ()
The address of the routine receiving control when the graPHIGS API detects an error.

Output Parameters

void (**old_err_hand) ()
The address of the previous error handling routine.

Errors

None

Related Subroutines

  • Error Handling

  • Error Logging

  • Inquire Error Handling Mode

  • Open PHIGS

  • Set Error Handling Mode


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