Museum

     XrmUniqueQuark(3X)                        XrmUniqueQuark(3X)



     NAME
          XrmUniqueQuark, XrmStringToQuark, XrmQuarkToString,
          XrmStringToQuarkList, XrmStringToBindingQuarkList -
          manipulate resource quarks

     SYNOPSIS
          XrmQuark XrmUniqueQuark()

          #define XrmStringToName(string)
          XrmStringToQuark(string) #define
          XrmStringToClass(string) XrmStringToQuark(string)
          #define XrmStringToRepresentation(string)
          XrmStringToQuark(string)

          XrmQuark XrmStringToQuark(string)
               char *string;

          #define XrmNameToString(name) XrmQuarkToString(name)
          #define XrmClassToString(class) XrmQuarkToString(class)
          #define XrmRepresentationToString(type)
          XrmQuarkToString(type)

          char *XrmQuarkToString(quark)
               XrmQuark quark;

          #define XrmStringToNameList(str, name)
          XrmStringToQuarkList((str), (name)) #define
          XrmStringToClassList(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
          bindings_return
                    Returns the binding list.

          quark     Specifies the quark for which the equivalent
                    string is desired.

          quarks_return
                    Returns the list of quarks.

          string    Specifies the string for which a quark is to
                    be allocated.



                                - 1 -

     XrmUniqueQuark(3X)                        XrmUniqueQuark(3X)



     DESCRIPTION
          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 to and from
          quark representations.  The string pointed to by the
          return value must not be modified or freed.  If no
          string exists for that quark, XrmQuarkToString returns
          NULL.

          The XrmQuarkToString function converts the specified
          resource quark representation back to a string.

          The XrmStringToQuarkList function converts the null-
          terminated string (generally a fully qualified name) to
          a list of quarks.  The components of the string are
          separated by a period or asterisk character.

          A binding list is a list of type XrmBindingList and
          indicates if components of name or class lists are
          bound tightly or loosely (that is, if wildcarding of
          intermediate components is specified).

          typedef enum {XrmBindTightly, XrmBindLoosely} XrmBinding, *XrmBindingList;

          XrmBindTightly indicates that a period separates the
          components, and XrmBindLoosely indicates that an
          asterisk separates the components.

          The XrmStringToBindingQuarkList function converts the
          specified string to a binding list and a quark list.
          Component names in the list are separated by a period
          or an asterisk character.  If the string does not start
          with period or asterisk, a period is assumed.  For
          example, ``*a.b*c'' becomes:

          quarks a       b      c
          bindings       loose  tightloose

     SEE ALSO
          XrmGetResource(3X11), XrmInitialize(3X11),
          XrmMergeDatabases(3X11), XrmPutResource(3X11)
          Xlib Programming Manual











                                - 2 -