XrmGetResource() XrmGetResource()
Name
XrmGetResource - get a resource from name and class as strings.
Synopsis
Bool XrmGetResource(database, str_name, str_class, str_type_return,
value_return)
XrmDatabase database;
char *str_name;
char *str_class;
char **str_type_return;
XrmValue *value_return;
Arguments
database Specifies the database that is to be used.
str_name Specifies the fully qualified name of the value being retrieved.
str_class Specifies the fully qualified class of the value being retrieved.
str_type_return
Returns a pointer to the representation type of the destination. In this function, the representation type is represented as a
string, not as an XrmRepresentation.
value_return
Returns the value in the database. Do not modify or free this data.
Returns
True if the resource was found, else False.
Description
XrmGetResource() retrieves a resource from the specified database. It takes a fully qualified name/class pair, a destination resource rep-
resentation, and the address of a value (size/address pair). The value and returned type point into database memory; therefore, you must
not modify the data.
The database only frees or overwrites entries on XrmPutResource(), XrmQPutResource(), or XrmMergeDatabases(). A client that is not storing
new values into the database or is not merging the database should be safe using the address passed back at any time until it exits. If a
resource was found, XrmGetResource() returns True; otherwise it returns False.
Most applications and toolkits do not make random probes into a resource database to fetch resources. The X toolkit access pattern for a
resource database is quite stylized. A series of from 1 to 20 probes are made with only the last name/class differing in each probe.
XrmGetResource() uses at worst a 2n algorithm, where n is the length of the name/class list. This can be improved upon by the application
programmer by prefetching a list of database levels that might match the first part of a name/class list.
Structures
XrmDatabase is a pointer to an opaque data type.
typedef struct {
unsigned int size;
XPointer addr;
} XrmValue;
See Also
XrmDestroyDatabase(), XrmGetFileDatabase(), XrmGetStringDatabase(), XrmInitialize(), XrmMergeDatabases(), XrmParseCommand(), XrmPutFile-
Database(), XrmPutLineResource(), XrmPutResource(), XrmPutStringResource(), XrmQGetResource(), XrmQGetSearchList(), XrmQGetSearchRe-
source(), XrmQPutResource(), XrmQPutStringResource(), XrmQuarkToString(), XrmStringToBindingQuarkList(), XrmStringToQuarkList(), XrmString-
ToQuark(), XrmUniqueQuark().
Xlib - Resource Manager XrmGetResource()
