XrmPutResource(3X) XrmPutResource(3X)
NAME
XrmPutResource, XrmQPutResource, XrmPutStringResource,
XrmQPutStringResource, XrmPutLineResource - store
database resources
SYNOPSIS
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.
- 1 -
XrmPutResource(3X) XrmPutResource(3X)
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 Programming Manual
- 2 -