XrmUniqueQuark(3X11)RISC/os Reference Manual XrmUniqueQuark(3X11)



NAME
     XrmUniqueQuark, XrmStringToQuark, XrmQuarkToString,
     XrmStringToQuarkList, XrmStringToBindingQuarkList - manipu-
     late 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
     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.





                         Printed 1/24/91         Release 4 Page 1

XrmUniqueQuark(3X11)RISC/os Reference Manual XrmUniqueQuark(3X11)



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 indi-
     cates if components of name or class lists are bound tightly
     or loosely (that is, if wildcarding of intermediate com-
     ponents is specified).

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

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

     The XrmStringToBindingQuarkList function converts the speci-
     fied 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











Release 4 Page 2         Printed 1/24/91