XrmUniqueQuark(3X)                             XrmUniqueQuark(3X)



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

SYNOPSIS
     XrmQuark XrmUniqueQuark ()

     #defineXrmStringToName(string) XrmStringToQuark(string)
     #defineXrmStringToClass(string) \
          XrmStringToQuark(string)
     #defineXrmStringToRepresentation(string) \
          XrmStringToQuark(string)

     XrmQuark XrmStringToQuark ( string )
     char * string;

     #defineXrmNameToString(name) XrmQuarkToString(name)
     #defineXrmClassToString(class) XrmQuarkToString(class)
     #defineXrmRepresentationToString(type) \
          XrmQuarkToString(type)

     char *XrmQuarkToString ( quark )
     XrmQuark quark;

     #defineXrmStringToNameList(str, name) \
          XrmStringToQuarkList((str), (name))
     #defineXrmStringToClassList(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;

DESCRIPTION
     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.

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

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




November, 1990                                                  1

XrmUniqueQuark(3X)                             XrmUniqueQuark(3X)



     The XrmQuarkToString function converts the specified
     resource quark representation back to a string.  If no
     string exists for the specified quark, XrmQuarktoString re-
     turns NULL.

     The XrmStringToQuarkList function converts the null-
     terminated string (generally a fully qualified name) to a
     list of quarks. The string must be in valid ResourceName
     format (see Section 10.11 of Xlib - C Language Interface.)
     The components of the string are separated by a period (.)
     or asterisk (*) character.

     The XrmStringToBindingQuarkList function converts the speci-
     fied string to a binding list and quark list.  A binding
     list is a list of type XrmBindingList and indicates if com-
     ponents of name and class lists are bound tightly or loosely
     (that is, if wildcards for intermediate components is speci-
     fied).  XrmBindTightly indicates that a period (.) separates
     the components, and XrmBindLoosely indicates that an aster-
     isk (*) separates the components.  XrmBindTightly and
     XrmBindLoosely are defined as follows.

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

     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


   Arguments
     These functions accept the following arguments:

     bindings-return
             Returns the binding list.

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

     quark-return
             Returns the list of quarks.

     string  Specifies the string for which a quark is to be al-
             located.

SEE ALSO
     XrmGetResource(3X), XrmInitialize(3X),
     XrmMergeDatabases(3X), XrmPutResource(3X)

     Xlib - C Language Interface




2                                                  November, 1990