NAME

XtDatabase − obtain the resource database for a display. 

Synopsis

XrmDatabase XtDatabase(display)

    Display *display;

Inputs

displaySpecifies the display for which the resource database should be returned. 

Returns

The database for the specified display, or NULL. 

Description

In Release 4 and previous releases, XtDatabase() returns the resource database built by XtDisplayInitialize() for the display.  In Release 5, which supports a resource database for each screen, XtDatabase() returns the resource database built by XtDisplayInitialize() for the default screen of the display.  In Release 4 and previous releases, the results are undefined if display has not been initialized by XtDisplayInitialize().  In Release 5, XtDatabase() returns NULL if no database has been set for the display. 

Usage

In Release 5, the function XtScreenDatabase() returns the resource associated with a specified screen.  You should rarely need to obtain the database of a display or screen.  XtGetApplicationResources() and related functions provide a more manageable approach to obtaining resource values. 

Structures

XrmDatabase is an opaque data type. 

See Also

XtAppInitialize(1), XtDisplayInitialize(1), XtScreenDatabase(1). 

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