NAME

XrmGetResource, XrmQGetResource, XrmQGetSearchList, XrmQGetSearchResource − retrieve database resources and search lists

SYNTAX

Bool XrmGetResource(database, str_name, str_class, str_type_return, str_value_return)
     XrmDatabase database;
     char ∗str_name;
     char ∗str_class;
     char ∗∗str_type_return;
     XrmValue ∗value_return;

Bool XrmQGetResource(database, quark_name, quark_class, quark_type_return, value_return)
     XrmDatabase database;
     XrmNameList quark_name;
     XrmClassList quark_class;
     XrmRepresentation ∗quark_type_return;
     XrmValue ∗value_return;

Bool XrmQGetSearchList(database, names, classes, list_return, list_length)
     XrmDatabase database;
     XrmNameList names;
     XrmClassList classes;
     XrmSearchList list_return;
     int list_length;

Bool XrmQGetSearchResource(list, name, class, type_return, value_return)
     XrmSearchList list;
     XrmName name;
     XrmClass class;
     XrmRepresentation ∗type_return;
     XrmValue ∗value_return;

ARGUMENTS

classesSpecifies a list of resource classes. 

databaseSpecifies the database that is to be used. 

listSpecifies the search list returned by XrmQGetSearchList.

list_lengthSpecifies the number of entries (not the byte size) allocated for list_return. 

list_returnReturns a search list for further use. 

str_classSpecifies the fully qualified class of the value being retrieved (as a string). 

namesSpecifies a list of resource names. 

str_type_return
Returns a pointer to the representation type of the destination (as a string).

quark_classSpecifies the fully qualified class of the value being retrieved (as a quark). 

quark_nameSpecifies the fully qualified name of the value being retrieved (as a quark). 

quark_type_return
Returns a pointer to the representation type of the destination (as a quark).

str_nameSpecifies the fully qualified name of the value being retrieved (as a string). 

value_returnReturns the value in the database. 

DESCRIPTION

The XrmGetResource and XrmQGetResource functions retrieve a resource from the specified database.

The XrmQGetSearchList function takes a list of names and classes and returns a list of database levels where a match might occur.

The XrmQGetSearchResource function searches the specified database levels for the resource that is fully identified by the specified name and class.

SEE ALSO

XrmInitialize(3X), XrmMergeDatabases(3X), XrmPutResource(3X), XrmUniqueQuark(3X)
Xlib − C Language X Interface

1 March 1988