XrmPutResource(3X11)                 SysV                 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 a pointer to the resource database.

     line      Specifies the resource value pair as a single string.  A single
               colon (:) separates the name from the value.

     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 routine that takes both the resource and value as null-
     terminated strings, converts them to quarks, and then calls
     XrmQPutResource, 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 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.

SEE ALSO
     XrmGetResource(3X11), XrmInitialize(3X11), XrmMergeDatabases(3X11),
     XrmUniqueQuark(3X11)
     Xlib - C Language X Interface