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 gen‐
erated. Must be NULL-terminated. The components may be sep‐
arated by the dot (.) character (tight binding) or the aster‐
isk (*) character (loose binding).
quarks_return
Returns the list of quarks.
DescriptionXrmStringToQuarkList() 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 bind‐
ing (the "." character) or a loose binding ("*"). Use XrmStringToBind‐
ingQuarkList() 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 Prefer‐
ences.
Structures
typedef int XrmQuark *XrmQuarkList;
#define XrmStringToNameList(str, name) XrmStringToQuarkList((str), (name))
#define XrmStringToClassList(str,class) XrmStringToQuarkList((str), (class))
See AlsoXrmDestroyDatabase(), XrmGetFileDatabase(), XrmGetResource(), XrmGet‐
StringDatabase(), XrmInitialize(), XrmMergeDatabases(), XrmParseCom‐
mand(), XrmPutFileDatabase(), XrmPutLineResource(), XrmPutResource(),
XrmPutStringResource(), XrmQGetResource(), XrmQGetSearchList(),
XrmQGetSearchResource(), XrmQPutResource(), XrmQPutStringResource(),
XrmQuarkToString(), XrmStringToBindingQuarkList(), XrmStringToQuark(),
XrmStringToRepresentation, XrmUniqueQuark().
Xlib - Resource Manager XrmStringToQuarkList()