Name

XtAppError — call the installed fatal error procedure. 

Synopsis

void XtAppError(app_context, message)

    XtAppContext app_context;
    String message;

Arguments

app_context
Specifies the application context.

messageSpecifies the message to be reported. 

Description

Xt provides two levels of error handling:

•A high-level interface that takes an error name and class and looks the error up in an error resource database. 

•A low-level interface that takes a simple string, which is printed out as the error message. 

Application-context-specific error handling is not implemented on many systems.  Most implementations will have just one set of error handlers.  If different handlers are set for different application contexts, the one set last will be used. 

In theory, most programs should use XtAppErrorMsg (or XtErrorMsg if application contexts are not being used), not XtAppError or XtError, so that the programs can be easily customized to provide international or other custom error messages.  However, the low-level handlers are much easier to use. 

XtAppError calls the low-level fatal error handler.  Fatal errors are assumed to be catastrophic and irrecoverable.  A warning error handler also exists for errors that require attention but do not preempt a program running correctly to a normal successful completion.  (XtAppWarning calls the corresponding nonfatal error handler.  XtAppErrorMsg and XtAppWarningMsg call the corresponding high-level handlers.) 

See Also

XtAppErrorMsg(1), XtAppSetErrorHandler(1), XtAppSetErrorMsgHandler(1), XtAppSetWarningHandler(1), XtAppSetWarningMsgHandler(1), XtAppWarning(1), XtAppWarningMsg(1),
XtErrorHandler(2).