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



NAME
     XrmPutResource, XrmQPutResource, XrmPutStringResource,
     XrmQPutStringResource, XrmPutLineResource - store database
     resources

SYNTAX
     void XrmPutResource(database, specifier, type, value)
          XrmDatabase *database;
          char *specifier;
          char *type;
          XrmValue *value;

     void XrmQPutResource(database, bindings, quarks, type,
     value)
          XrmDatabase *database;
          XrmBindingList bindings;
          XrmQuarkList quarks;
          XrmRepresentation type;
          XrmValue *value;

     void XrmPutStringResource(database, specifier, value)
          XrmDatabase *database;
          char *specifier;
          char *value;

     void XrmQPutStringResource(database, bindings, quarks,
     value)
          XrmDatabase *database;
          XrmBindingList bindings;
          XrmQuarkList quarks;
          char *value;

     void XrmPutLineResource(database, line)
          XrmDatabase *database;
          char *line;

ARGUMENTS
     bindings  Specifies a list of bindings.

     database  Specifies the resource database.

     line      Specifies the resource name and value pair as a
               single string in the valid ResourceLine format
               (see section 10.11).  A single colon (:) separates
               the name from the value.  Note that comment lines
               are not stored.

     quarks    Specifies the complete or partial name or the
               class list of the resource.

     specifier Specifies a complete or partial specification of
               the resource.



                         Printed 1/24/91         Release 4 Page 1

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



     type      Specifies the type of the resource.

     value     Specifies the value of the resource, which is
               specified as a string.

DESCRIPTION
     If database contains NULL, XrmPutResource creates a new
     database and returns a pointer to it.  XrmPutResource is a
     convenience function that calls XrmStringToBindingQuarkList
     followed by:

     XrmQPutResource(database, bindings, quarks, XrmStringToQuark(type), value)

     If database contains NULL, XrmQPutResource creates a new
     database and returns a pointer to it.

     If database contains NULL, XrmPutStringResource creates a
     new database and returns a pointer to it.
     XrmPutStringResource adds a resource with the specified
     value to the specified database.  XrmPutStringResource is a
     convenience function that first calls XrmStringToBin-
     dingQuarkList on the specifier and then calls XrmQPu-
     tResource, using a ``String'' representation type.

     If database contains NULL, XrmQPutStringResource creates a
     new database and returns a pointer to it.
     XrmQPutStringResource is a convenience routine that con-
     structs an XrmValue for the value string (by calling strlen
     to compute the size) and then calls XrmQPutResource, using a
     ``String'' representation type.

     If database contains NULL, XrmPutLineResource creates a new
     database and returns a pointer to it.  XrmPutLineResource
     adds a single resource entry to the specified database.  Any
     white space before or after the name or colon in the line
     argument is ignored.  The value is terminated by a new-line
     or a NULL character.  To allow values to contain embedded
     new-line characters, a ``\n'' is recognized and replaced by
     a new-line character.  For example, line might have the
     value ``xterm*background:green\n''.  Null-terminated strings
     without a new line are also permitted.

     To allow values to contain arbitrary octets, the 4-character
     sequence \nnn, where n is a digit in the range of "0"-"7",
     is recognized and replaced with a single byte that contains
     this sequence interpreted as an octal number.  For example,
     a value containing a NULL byte can be stored by specifying
     "\000" in the string.

SEE ALSO
     XrmGetResource(3X11), XrmInitialize(3X11),
     XrmMergeDatabases(3X11), XrmUniqueQuark(3X11)



Release 4 Page 2         Printed 1/24/91

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



     Xlib - C Language X Interface






















































                         Printed 1/24/91         Release 4 Page 3