XrmPutResource(3X11)						     MIT X11R4						      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.  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, creates a new database and returns a pointer to it.  is a convenience function that calls followed by:

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

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

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

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

       If database contains NULL, creates a new database and returns a pointer to it.  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 charac-
       ter.  To allow values to contain embedded new-line characters, a ``
'' is recognized and replaced by a new-line character.  For example,
       line might have the value ``xterm*background:green
''.	Null-terminated strings without a new line are also permitted.

       To allow values to contain arbitrary octets, the 4-character sequence 
nn, 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 "00" in the string.

See Also
       XrmGetResource(3X11), XrmInitialize(3X11), XrmMergeDatabases(3X11), XrmUniqueQuark(3X11)
       X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys

															      XrmPutResource(3X11)