XrmPutResource(3X11)X Version 11 (Release 4) 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.




  Page 1                                          (printed 8/30/91)

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



       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.

       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
       XrmStringToBindingQuarkList on the specifier and then calls
       XrmQPutResource, using a ``String'' representation type.

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


  Page 2                                          (printed 8/30/91)

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



       XrmQPutStringResource is a convenience routine that
       constructs 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)
       Xlib - C Language X Interface















  Page 3                                          (printed 8/30/91)