Amiga Unix — 68040 · 68060

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