XtAppError(3x) — HP-UX ANSI C A.09.00

NAME

XtAppError − call the low-level error handler.

Synopsis

void XtAppError(app_context, message)

XtAppContext app_context;
String message;

Inputs

app_context
Specifies the application context.

messageSpecifies the error message to be reported.

Returns

XtAppError() terminates the application and does not return.

Description

XtAppError() passes its arguments to the installed low-level error handler. On POSIX systems, the default handler is _XtDefaultError(). It prints the message to the stderr stream and calls exit().

Usage

To report non-fatal error messages or warnings without exiting, use XtAppWarning() or XtAppWarningMsg(). To change the low-level error handler, use XtAppSetErrorHandler(). XtAppError() calls the "low-level" error handler. It is better to use XtAppErrorMsg() which calls the "high-level" error handler. The high-level handler looks up the error message in a resource database and so allows for customization and internationalization of error messages. Although the Intrinsics interface allows separate error and warning handlers for each application context, most implementations will support only a single set of handlers. When a new handler is installed, it will be used in all application contexts.

Museum