xtapperror(3) [hpux man page]

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()

XtAppError(3Xt) 						   XT FUNCTIONS 						   XtAppError(3Xt)

NAME

       XtAppError, XtAppSetErrorHandler, XtAppSetWarningHandler, XtAppWarning - low-level error handlers

SYNTAX

       void XtAppError(app_context, message)
	     XtAppContext app_context;
	     String message;

       void XtAppSetErrorHandler(app_context, handler)
	     XtAppContext app_context;
	     XtErrorHandler handler;

       void XtAppSetWarningHandler(app_context, handler)
	     XtAppContext app_context;
	     XtErrorHandler handler;

       void XtAppWarning(app_context, message)
	     XtAppContext app_context;
	     String message;

ARGUMENTS

       app_context
		 Specifies the application context.

       message	 Specifies the nonfatal error message that is to be reported.  or the nonfatal error procedure, which usually returns

       handler	 Specifies the new fatal error procedure, which should not return,.

       message	 Specifies the message that is to be reported.

DESCRIPTION

       The XtAppError function calls the installed error procedure and passes the specified message.

       The XtAppSetErrorHandler function registers the specified procedure, which is called when a fatal error condition occurs.

       The XtAppSetWarningHandler registers the specified procedure, which is called when a nonfatal error condition occurs.

       The XtAppWarning function calls the installed nonfatal error procedure and passes the specified message.

SEE ALSO

       XtAppGetErrorDatabase(3Xt), XtAppErrorMsg(3Xt)
       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface

X Version 11							    Release 6.6 						   XtAppError(3Xt)