Name

XtAppGetErrorDatabase — obtain the error database. 

Synopsis

XrmDatabase ∗XtAppGetErrorDatabase(app_context)

    XtAppContext app_context;

Arguments

app_context
Specifies the application context.

Description

Xt’s high-level error and warning message handlers use a resource-like database for storing error messages.  On POSIX-based systems, the error database is usually stored in the file /usr/lib/X11/XtErrorDB.  However, it is possible to have separate application-context-specific databases. 

To obtain the error database (for example, to merge with an application or widget-specific database), use XtAppGetErrorDatabase. 

The XtAppGetErrorDatabase function returns the address of the error database.  The Intrinsics do a lazy binding of the error database and do not merge in the database file until the first call to XtAppGetErrorDatabaseText. 

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. 

The high-level error and warning handler procedure pointers are of type XtErrorMsgHandler.  For a complete listing of all errors and warnings that can be generated by the Intrinsics, see Appendix D, Standard Errors and Warnings. 

Structures

The type XrmDatabase is opaque and should not be manipulated directly.  The return value can be manipulated with the Xlib functions XrmPutResource, XrmQPutResource, XrmGetResource, and XrmQGetResource. 

See Also

XtAppGetErrorDatabaseText(1), XtGetErrorDatabase(1), XtGetErrorDatabaseText(1),
XtErrorMsgHandler(2).