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

bindingsSpecifies a list of bindings. 

databaseSpecifies the resource database. 

lineSpecifies 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. 

quarksSpecifies the complete or partial name or the class list of the resource. 

specifierSpecifies a complete or partial specification of the resource. 

typeSpecifies the type of the resource. 

valueSpecifies 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. 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)
X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys