Manual pages › X Window and screen libraries (3X)
XPutRes(3X)
store database resources
From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.
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.
XWIN 3.0 Last change: 9/1/88 .ie t
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'' representa- tion type. If database contains NULL, XrmQPutStringResource creates a new database and returns a pointer to it. XrmQPutStringResource is a convenience routine that con- structs 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
XWIN 3.0 Last change: 9/1/88 .ie t
XWIN 3.0 Last change: 9/1/88 .ie t