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