hpux man page for xrmgetresource

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()