NAME

Synopsis

XrmQuark XrmStringToQuark(string)
     char *string; #define XrmStringToClass(string) XrmStringToQuark(string) #define XrmStringToRepresentation(string) XrmStringToQuark(string)

Arguments

stringSpecifies the string for which a quark is to be allocated. 

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.  XrmStringToRepresentation() are macros that 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 11, Managing User Preferences. 

Structures

typedef int XrmQuark;

See Also

XrmDestroyDatabase(), XrmGetFileDatabase(), XrmGetResource(), XrmGetStringDatabase(), XrmInitialize(), XrmMergeDatabases(), XrmParseCommand(), XrmPutFileDatabase(), XrmPutLineResource(), XrmPutResource(), XrmPutStringResource(), XrmQGetResource(), XrmQGetSearchList(), XrmQGetSearchResource(), XrmQPutResource(), XrmQPutStringResource(), XrmQuarkToString(), XrmStringToBindingQuarkList(), XrmStringToQuarkList(), XrmUniqueQuark(). 

Copyright O’Reilly & Assoc.  —