XrmUniqueQuark(3X11)X Version 11 (Release 4) XrmUniqueQuark(3X11)



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

  SYNTAX
       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



  Page 1                                          (printed 8/30/91)

  XrmUniqueQuark(3X11)X Version 11 (Release 4) XrmUniqueQuark(3X11)



       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.

  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.  Note that the string must be in the valid
       ResourceName format (see section 10.11).  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


  Page 2                                          (printed 8/30/91)

  XrmUniqueQuark(3X11)X Version 11 (Release 4) XrmUniqueQuark(3X11)



       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 - C Language X Interface


























  Page 3                                          (printed 8/30/91)