NAME
XrmStringToQuarkList − convert a key string to a quark list.
Synopsis
void XrmStringToQuarkList(string, quarks_return)
char *string;
XrmQuarkList quarks_return;
Arguments
stringSpecifies the string for which a list of quarks is to be generated. Must be null-terminated. The components may be separated by the "." character (tight binding) or the "*" 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. 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 11, Managing User Preferences.
Structures
typedef int XrmQuark *XrmQuarkList;
#define XrmStringToClassList(str,class) XrmStringToQuarkList((str), (class))
See Also
XrmDestroyDatabase(), XrmGetFileDatabase(), XrmGetResource(), XrmGetStringDatabase(), XrmInitialize(), XrmMergeDatabases(), XrmParseCommand(), XrmPutFileDatabase(), XrmPutLineResource(), XrmPutResource(), XrmPutStringResource(), XrmQGetResource(), XrmQGetSearchList(), XrmQGetSearchResource(), XrmQPutResource(), XrmQPutStringResource(), XrmQuarkToString(), XrmStringToBindingQuarkList(), XrmStringToQuark(), XrmStringToRepresentation, XrmUniqueQuark().
Copyright O’Reilly & Assoc. —