Name

XtAppWarning — call the installed nonfatal error procedure. 

Synopsis

void XtAppWarning(app_context, message)

    XtAppContext app_context;
    String message;

Arguments

app_context
Specifies the application context.

messageSpecifies the nonfatal error message that is 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 XtAppWarningMsg, not XtAppWarning, so that 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 non-fatal error handler.  XtAppErrorMsg and XtAppWarningMsg call the corresponding high-level handlers.) 

See Also

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