hpux man page for xrmstringtb

XrmStringToQuark()														XrmStringToQuark()

Name
  XrmStringToQuark, XrmStringToName, XrmStringToClass, XrmStringToRepresentation - convert a string to a quark.

Synopsis
  XrmQuark XrmStringToQuark(string)
	  char *string;

     #define  XrmStringToName(string)  XrmStringToQuark(string)  #define XrmStringToClass(string) XrmStringToQuark(string) #define XrmString-
     ToRepresentation(string) XrmStringToQuark(string)

Arguments
  string    Specifies the string for which a quark is to be allocated.

Returns
  The quark.

Description
  XrmStringToQuark() returns a quark that will represent the specified string.	If the string is not in the Host Portable Character Encoding,
  the conversion is implementation-dependent.  Since string is copied, it may be freed.  XrmQuarkToString() performs the inverse function.

  A  quark  is an integer representation of a string.  Since the resource manager needs to make many comparisons of strings when it gets data
  from the database, it is more efficient to convert these strings into quarks, and to compare quarks instead.	Since  quarks  are  presently
  represented by integers, comparing quarks is trivial.

  The  macros  XrmStringToName(),  XrmStringToClass(),	and XrmStringToRepresentation() provide alternate names for XrmStringToQuark().  They
  help document when a name, class, or representation (as opposed to some other type of string) is being converted into a quark.

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

Structures
     typedef int XrmQuark;

See Also
  XrmQGetResource(), XrmQGetSearchList(), XrmQGetSearchResource(), XrmQPutResource(), XrmQPutStringResource(), XrmQuarkToString(), XrmString-
  ToBindingQuarkList(), XrmStringToQuarkList(), XrmUniqueQuark().

Xlib - Resource Manager 													XrmStringToQuark()