XrmStringToQuarkList() XrmStringToQuarkList()
Name
XrmStringToQuarkList - convert a key string to a quark list.
Synopsis
void XrmStringToQuarkList(string, quarks_return)
char *string;
XrmQuarkList quarks_return;
Arguments
string Specifies the string for which a list of quarks is to be generated. Must be NULL-terminated. The components may be separated by
the dot (.) character (tight binding) or the asterisk (*) character (loose binding).
quarks_return
Returns the list of quarks.
Description
XrmStringToQuarkList() converts string (generally a fully qualified name/class string) to a list of quarks. If the string is not in the
Host Portable Character Encoding, the conversion is implementation-dependent. Components of the string may be separated by a tight binding
(the "." character) or a loose binding ("*"). Use XrmStringToBindingQuarkList() for lists which contain both tight and loose bindings.
See XrmGetResource() for a description of tight and loose binding.
Each component of the string is individually converted into a quark. See XrmStringToQuark() for information about quarks and converting
strings to quarks. quarks_return is a NULL-terminated list of quarks.
For example, xmh.toc.command.background is converted into a list of four quarks: the quarks for xmh, toc, command, and background, in that
order. A NULLQUARK is appended to the end of the list.
Note that XrmStringToNameList and XrmStringToClassList are macros that perform exactly the same function as XrmStringToQuarkList(). These
may be used in cases where they clarify the code.
For more information, see Volume One, Chapter 13, Managing User Preferences.
Structures
typedef int XrmQuark *XrmQuarkList;
#define XrmStringToNameList(str, name) XrmStringToQuarkList((str), (name))
#define XrmStringToClassList(str,class) XrmStringToQuarkList((str), (class))
See Also
XrmDestroyDatabase(), XrmGetFileDatabase(), XrmGetResource(), XrmGetStringDatabase(), XrmInitialize(), XrmMergeDatabases(), XrmParseCom-
mand(), XrmPutFileDatabase(), XrmPutLineResource(), XrmPutResource(), XrmPutStringResource(), XrmQGetResource(), XrmQGetSearchList(),
XrmQGetSearchResource(), XrmQPutResource(), XrmQPutStringResource(), XrmQuarkToString(), XrmStringToBindingQuarkList(), XrmStringToQuark(),
XrmStringToRepresentation, XrmUniqueQuark().
Xlib - Resource Manager XrmStringToQuarkList()
