NAME

XrmRepresentationToString − convert a quark to a string. 

Synopsis

#define XrmRepresentationToString(type) XrmQuarkToString(type) char *XrmQuarkToString(quark)
     XrmQuark quark;

Arguments

quarkSpecifies the quark for which the equivalent string is desired. 

Description

XrmRepresentationToString is an alias for XrmQuarkToString().  It returns the string for which the specified quark is serving as a shorthand symbol.  The quark was returned earlier by XrmStringToQuark or XrmStringToRepresentation().  The string pointed to by the return value must not be modified or freed, because that string is in the data structure used by the resource manager for assigning quarks.  If no string exists for that quark, XrmRepresentationToString returns NULL.  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 represented by integers, comparing quarks is trivial.  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(), XrmStringToBindingQuarkList(), XrmStringToQuarkList(), XrmStringToQuark(), XrmUniqueQuark(). 

Copyright O’Reilly & Assoc.  —