XtAppSetErrorHandler() XtAppSetErrorHandler()
Name
XtAppSetErrorHandler - set the low-level error handler procedure.
Synopsis
XtErrorHandler XtAppSetErrorHandler(app_context, handler)
XtAppContext app_context;
XtErrorHandler handler;
Inputs
app_context
Specifies the application context.
handler Specifies the new fatal error procedure, which should not return.
Returns
A pointer to the previously installed low-level error handler.
Description
XtAppSetErrorHandler() registers the procedure handler in app_context as the procedure to be invoked by XtAppError(). It returns a pointer
to the previously installed low-level fatal error handler. handler must terminate the application; if it returns the subsequent behavior
of the Intrinsics is undefined.
The default low-level error handler provided by the Intrinsics is _XtDefaultError(). On POSIX-based systems, it prints the message to
standard error and terminates the application.
Usage
Note that application-context-specific error handling is not implemented on many systems. Most implementations will have just one set of
error handlers. If they are set for different application contexts, the one performed last will prevail.
See Also
XtAppError(1), XtAppErrorMsg(1), XtAppSetErrorMsgHandler(1), XtAppSetWarningHandler(1), XtAppSetWarningMsgHandler(1), XtAppWarning(1),
XtAppWarningMsg(1),
XtErrorHandler(2).
Xt - Error Handling XtAppSetErrorHandler()
