hpux man page for xrmqgetseab

XrmQGetSearchResource() 												   XrmQGetSearchResource()

Name
  XrmQGetSearchResource - search prepared list for a given resource.

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

Arguments
  list	    Specifies the search list returned by XrmQGetSearchList().

  name	    Specifies the resource name.

  class     Specifies the resource class.

  type_return
	    Returns the data representation type.

  value_return
	    Returns the value from the database.

Returns
  True if the resource was found, else False.

Description
  XrmQGetSearchResource() is a tool for searching the database more efficiently.  It is used in combination with XrmQGetSearchList().  Often,
  one searches the database for many similar resources which differ only in their final component  (e.g.,  xmh.toc.foreground,	xmh.toc.back-
  ground,  etc).  Rather than looking for each resource in its entirety, XrmQGetSearchList() searches the database for the common part of the
  resource name, returning a whole list of items in the database that match it.  This list  is	called	the  search  list.   XrmQGetSearchRe-
  source()  searches  the  search  list  for the resource that is fully identified by name and class.  The search stops with the first match.
  XrmQGetSearchResource() returns True if the resource was found; otherwise, it returns False.

  A call to XrmQGetSearchList() with a name and class list containing all but the last component of a resource name followed  by  a  call  to
  XrmQGetSearchResource()  with  the  last component name and class returns the same database entry as XrmQGetResource() or XrmQGetResource()
  would with the fully qualified name and class.

  For more information, see Volume One, Chapter 13, Managing User Preferences.

Structures
  XrmDatabase is a pointer to an opaque data type.

     typedef XrmQuark XrmName;
     typedef XrmQuark XrmClass;
     typedef XrmQuark XrmRepresentation;

     typedef struct {
	 unsigned int	 size;
	 XPointer	 addr;
     } XrmValue, *XrmValuePtr;

  XrmSearchList is a pointer to an opaque data type.

See Also
  XrmDestroyDatabase(), XrmGetFileDatabase(), XrmGetResource(), XrmGetStringDatabase(),  XrmInitialize(),  XrmMergeDatabases(),  XrmParseCom-
  mand(),  XrmPutFileDatabase(),  XrmPutLineResource(),  XrmPutResource(),  XrmPutStringResource(),  XrmQGetResource(),  XrmQGetSearchList(),
  XrmQPutResource(), XrmQPutStringResource(), XrmQuarkToString(), XrmStringToBindingQuarkList(), XrmStringToQuarkList(),  XrmStringToQuark(),
  XrmUniqueQuark().

Xlib - Resource Manager 												   XrmQGetSearchResource()