XrmUniqueQuark, XrmStringToQuark, XrmPermStringToQuark,
       XrmQuarkToString, XrmStringToQuarkList, XrmStringToBind-
       ingQuarkList - manipulate resource quarks


SYNTAX

       XrmQuark XrmUniqueQuark()

       #define XrmStringToName(string) XrmStringToQuark(string)
       #define XrmStringToClass(string) XrmStringToQuark(string)
       #define XrmStringToRepresentation(string) XrmStringTo-
       Quark(string)

       XrmQuark XrmStringToQuark(string)
            char *string;

       XrmQuark XrmPermStringToQuark(string)
            char *string;

       #define XrmStringToName(string) XrmStringToQuark(string)
       #define XrmStringToClass(string) XrmStringToQuark(string)
       #define XrmStringToRepresentation(string) XrmStringTo-
       Quark(string)

       XrmQuark XrmStringToQuark(string)
            char *string;

       XrmQuark XrmPermStringToQuark(string)
            char *string;

       #define XrmNameToString(name) XrmQuarkToString(name)
       #define XrmClassToString(class) XrmQuarkToString(class)
       #define XrmRepresentationToString(type) XrmQuark-
       ToString(type)

       char *XrmQuarkToString(quark)
            XrmQuark quark;

       #define XrmStringToNameList(str, name)  XrmStringToQuark-
       List((str), (name)) #define XrmStringTo-
       ClassList(str,class) XrmStringToQuarkList((str), (class))

       void XrmStringToQuarkList(string, quarks_return)
            char *string;
            XrmQuarkList quarks_return;

       XrmStringToBindingQuarkList(string, bindings_return,
       quarks_return)
            char *string;
            XrmBindingList bindings_return;
            XrmQuarkList quarks_return;


ARGUMENTS

       The XrmUniqueQuark function allocates a quark that is
       guaranteed not to represent any string that is known to
       the resource manager.

       These functions can be used to convert from string to
       quark representation.  If the string is not in the Host
       Portable Character Encoding, the conversion is implementa-
       tion-dependent.  The string argument to XrmStringToQuark
       need not be permanently allocated storage.  XrmPermString-
       ToQuark is just like XrmStringToQuark, except that Xlib is
       permitted to assume the string argument is permanently
       allocated, and, hence, that it can be used as the value to
       be returned by XrmQuarkToString.

       For any given quark, if XrmStringToQuark returns a non-
       NULL value, all future calls will return the same value
       (identical address).

       These functions can be used to convert from quark repre-
       sentation to string.  The string pointed to by the return
       value must not be modified or freed.  The returned string
       is byte-for-byte equal to the original string passed to
       one of the string-to-quark routines.  If no string exists
       for that quark, XrmQuarkToString returns NULL.  For any
       given quark, if XrmQuarkToString returns a non-NULL value,
       all future calls will return the same value (identical
       address).

       These functions can be used to convert from string to
       quark representation.  If the string is not in the Host
       Portable Character Encoding, the conversion is implementa-
       tion-dependent.  The string argument to XrmStringToQuark
       need not be permanently allocated storage.  XrmPermString-
       ToQuark is just like XrmStringToQuark, except that Xlib is
       permitted to assume the string argument is permanently
       allocated, and, hence, that it can be used as the value to
       be returned by XrmQuarkToString.

       For any given quark, if XrmStringToQuark returns a non-
       NULL value, all future calls will return the same value
       (identical address).

       The XrmStringToQuarkList function converts the null-termi-
       nated string (generally a fully qualified name) to a list
       of quarks.  Note that the string must be in the valid
       ResourceName format (see section 15.1).  If the string is
       not in the Host Portable Character Encoding, the conver-
       sion is implementation-dependent.

       A binding list is a list of type XrmBindingList and indi-
       cates if components of name or class lists are bound
       tightly or loosely (that is, if wildcarding of intermedi-
       asterisk, a period is assumed.  For example, ``*a.b*c''
       becomes:

       quarks a       b      c
       bindings       loose  tightloose


SEE ALSO

       XrmGetResource(3X11), XrmInitialize(3X11), XrmMerge-
       Databases(3X11), XrmPutResource(3X11)
       Xlib - C Language X Interface



X Version 11               Release 6.4                          1