Name

XtAppSetErrorHandler — register a procedure to be called on fatal error conditions. 

Synopsis

XtErrorHandler XtAppSetErrorHandler(app_context, handler)

    XtAppContext app_context;
    XtErrorHandler handler;

Arguments

app_context
Specifies the application context.

handlerSpecifies the new fatal error procedure, which should not return. 

Description

XtAppSetErrorHandler returns a pointer to the previously installed low-level fatal error handler.  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. 

Using XtAppSetErrorHandler or XtSetErrorHandler, you can replace this default handler with one of your own. 

Fatal error handlers should not return.  If one does, subsequent X Toolkit behavior is undefined. 

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