xrmquarktostring(3) [hpux man page]
XrmQuarkToString() XrmQuarkToString() Name XrmQuarkToString - convert a quark to a string. Synopsis char *XrmQuarkToString(quark) XrmQuark quark; Arguments quark Specifies the quark for which the equivalent string is desired. Returns The string. Description XrmQuarkToString() returns the string for which the specified quark is serving as a shorthand symbol. The quark was earlier set to repre- sent the string by XrmStringToQuark(). 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, XrmQuarkToString() 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. The three #define statements in the Structures section provide an extra level of abstraction. They define macros so that names, classes and representations can also be represented as quarks. For more information, see Volume One, Chapter 13, Managing User Preferences. Structures typedef int XrmQuark; /* macro definitions from <X11/Xresource.h> */ #define XrmNameToString(name) XrmQuarkToString(name) #define XrmClassToString(class) XrmQuarkToString(class) #define XrmRepresentationToString(type) XrmQuarkToString(type) See Also XrmDestroyDatabase(), XrmGetFileDatabase(), XrmGetResource(), XrmGetStringDatabase(), XrmInitialize(), XrmMergeDatabases(), XrmParseCom- mand(), XrmPutFileDatabase(), XrmPutLineResource(), XrmPutResource(), XrmPutStringResource(), XrmQGetResource(), XrmQGetSearchList(), XrmQGetSearchResource(), XrmQPutResource(), XrmQPutStringResource(), XrmStringToBindingQuarkList(), XrmStringToQuarkList(), XrmStringTo- Quark(), XrmUniqueQuark(). Xlib - Resource Manager XrmQuarkToString()
Check Out this Related Man Page
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()