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.

handlerSpecifies 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

XtAppErrorUNIX SYSTEM V/68, XtAppErrorMsgUNIX SYSTEM V/68, XtAppSetErrorMsgHandlerUNIX SYSTEM V/68, XtAppSetWarningHandlerUNIX SYSTEM V/68, XtAppSetWarningMsgHandlerUNIX SYSTEM V/68, XtAppWarningUNIX SYSTEM V/68, XtAppWarningMsgUNIX SYSTEM V/68,
XtErrorHandlerUNIX SYSTEM V/88.