X Version 11 (1 September 1988) XrmPutResource(XS)
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(XS), XrmInitialize(XS),
XrmMergeDatabases(XS), XrmUniqueQuark(XS)
Xlib - C Language X Interface
(printed 2/12/90) (1 September 1988) XrmPutResource(XS)