XtAppGetErrorDatabase() XtAppGetErrorDatabase()
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 han-
dlers 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 mak-
ing a single dummy call to XtAppGetErrorDatabaseText() and then calling XtAppGetErrorDatabase().
See Also
XtAppErrorMsg(1), XtAppGetErrorDatabaseText(1), XtAppWarningMsg(1),
XtErrorMsgHandler(2).
Xt - Error Handling XtAppGetErrorDatabase()