hpux man page for xrmqgetresource

XrmQGetResource()														 XrmQGetResource()

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;
	  XrmNameList quark_name;
	  XrmClassList quark_class;
	  XrmRepresentation *quark_type_return;
	  XrmValue *value_return;

Arguments
  database  Specifies 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.

Returns
  True if the resource was found, else False.

Description
  XrmQGetResource()  retrieves a resource from the specified database.	It takes fully qualified name and class strings, and returns the rep-
  resentation 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 13, Managing User Preferences.

Structures
  XrmDatabase is a pointer to an opaque data type.

     typedef XrmQuarkList XrmNameList;
     typedef XrmQuarkList XrmClassList;
     typedef XrmQuark	  XrmRepresentation;

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

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

Xlib - Resource Manager 													 XrmQGetResource()