NAME

XrmQGetResource − get a resource value using name and class as quarks. 

Synopsis

Bool XrmQGetResource(database, quark_name, quark_class,

quark_type_return, value_return)
     XrmDatabase database;
     XrmClassList quark_class;
     XrmRepresentation *quark_type_return;
     XrmValue *value_return;

Arguments

databaseSpecifies the database that is to be used. 

quark_name
Specifies the fully qualified name of the value being retrieved (as a list of quarks).

quark_class
Specifies the fully qualified class of the value being retrieved (as a list of quarks).

quark_type_return
Returns a pointer to the representation type of the value. In this function, the representation type is represented as a quark.

value_return
Returns a pointer to the value in the database. Do not modify or free this data.

Description

XrmQGetResource() retrieves a resource from the specified database.  It takes fully qualified name and class strings, and returns the representation and value of the matching resource.  The value returned points into database memory; you must not modify that data.  If a resource was found, XrmQGetResource() returns True.  Otherwise, it returns False.  Currently, the database only frees or overwrites entries when new data is stored with XrmMergeDatabases(), or XrmPutResource() and related routines.  A client that avoids these functions should be safe using the address passed back at any time until it exits.  XrmQGetResource() is very similar to XrmGetResource(), except that in XrmGetResource(), the equivalent arguments to quark_name, quark_class, and quark_type_return arguments are strings instead of quarks.  See XrmGetResource() for a full description of how data is looked up in the database.  For more information, see Volume One, Chapter 11, Managing User Preferences. 

Structures

XrmDatabase is a pointer to an opaque data type.
 typedef XrmQuarkList XrmClassList;
typedef XrmQuark     XrmRepresentation;
 typedef struct {
unsigned int    size;
XPointer        addr;
} XrmValue, *XrmValuePtr;

See Also

XrmDestroyDatabase(), XrmGetFileDatabase(), XrmGetResource(), XrmGetStringDatabase(), XrmInitialize(), XrmMergeDatabases(), XrmParseCommand(), XrmPutFileDatabase(), XrmPutLineResource(), XrmPutResource(), XrmPutStringResource(), XrmQGetSearchList(), XrmQGetSearchResource(), XrmQPutResource(), XrmQPutStringResource(), XrmQuarkToString(), XrmStringToBindingQuarkList(), XrmStringToQuarkList(), XrmStringToQuark(), XrmUniqueQuark(). 

Copyright O’Reilly & Assoc.  —