XrmPutResource(3X11)    COMMAND REFERENCE    XrmPutResource(3X11)



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.



X Version 11            1 September 1988                        1

XrmPutResource(3X11)    COMMAND REFERENCE    XrmPutResource(3X11)



     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 - C Language X Interface










X Version 11            1 September 1988                        2

%%index%%
na:552,185;
sy:737,2827;
de:3564,2425;
se:5989,338;
%%index%%000000000085