xtappsetera(3) [hpux man page]

XtAppSetErrorHandler()													    XtAppSetErrorHandler()

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.

  handler   Specifies 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
  XtAppError(1), XtAppErrorMsg(1), XtAppSetErrorMsgHandler(1), XtAppSetWarningHandler(1), XtAppSetWarningMsgHandler(1), XtAppWarning(1),
  XtAppWarningMsg(1),
  XtErrorHandler(2).

Xt - Error Handling													    XtAppSetErrorHandler()

XtAppError()															      XtAppError()

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.

  message   Specifies 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 mes-
  sages.

  Although  the  Intrinsics interface allows separate error and warning handlers for each application context, most implementations will sup-
  port only a single set of handlers.  When a new handler is installed, it will be used in all application contexts.

See Also
  XtAppErrorMsg(1), XtAppSetErrorHandler(1), XtAppSetErrorMsgHandler(1), XtAppSetWarningHandler(1), XtAppSetWarningMsgHandler(1), XtAppWarn-
  ing(1), XtAppWarningMsg(1),
  XtErrorHandler(2).  XtErrorMsgHandler(2).

Xt - Error Handling														      XtAppError()