NAME

XtAppGetErrorDatabase − obtain the default error database. 

Synopsis

XrmDatabase *XtAppGetErrorDatabase(app_context)

    XtAppContext app_context;

Inputs

app_context
Specifies the application context.

Returns

The address of an XrmDatabase. 

Description

XtAppGetErrorDatabase() returns the address of the XrmDatabase error message database used by the default high-level error and warning handlers for app_context.  This database may be empty until XtAppGetErrorDatabaseText() is called for the first time.  While the X Toolkit specification permits individual error databases for each application context, most implementations will only support a single database.  In the MIT implementation, the error database file is /usr/lib/X11/XtErrorDB. 

Usage

You should never need to call this function if you simply want to report error and warning messages through the standard handlers.  Because the Intrinsics do not support the customization and internationalization of error messages very well, some applications may want to override values in the default database with their own customized messages.  The default database can be obtained for this purpose by making a single dummy call to XtAppGetErrorDatabaseText() and then calling XtAppGetErrorDatabase(). 

See Also

XtAppErrorMsg(1), XtAppGetErrorDatabaseText(1), XtAppWarningMsg(1),
XtErrorMsgHandler(2). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates