XrmPutResource(3X11)      XLIB FUNCTIONS     XrmPutResource(3X11)


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 the resource database.

       line      Specifies the resource name and value pair as a
                 single string.

       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.



X Version 11                Release 5                           1

XrmPutResource(3X11)      XLIB FUNCTIONS     XrmPutResource(3X11)


DESCRIPTION
       If database contains NULL, XrmPutResource creates a new
       database and returns a pointer to it.  XrmPutResource is a
       convenience function that calls XrmStringToBindingQuark-
       List followed by:

       XrmQPutResource(database, bindings, quarks, XrmStringToQuark(type), value)
If the specifier and type are not in the Host Portable Character
Encoding the result is implementation dependent.  The value is
stored in the database without modification.

       If database contains NULL, XrmQPutResource creates a new
       database and returns a pointer to it.  If a resource entry
       with the identical bindings and quarks already exists in
       the database, the previous value is replaced by the new
       specified value.  The value is stored in the database
       without modification.

       If database contains NULL, XrmPutStringResource creates a
       new database and returns a pointer to it.  XrmPutStringRe-
       source adds a resource with the specified value to the
       specified database.  XrmPutStringResource is a convenience
       function that first calls XrmStringToBindingQuarkList on
       the specifier and then calls XrmQPutResource, using a
       ``String'' representation type.  If the specifier is not
       in the Host Portable Character Encoding the result is
       implementation dependent.  The value is stored in the
       database without modification.

       If database contains NULL, XrmQPutStringResource creates a
       new database and returns a pointer to it.  XrmQPut-
       StringResource is a convenience routine that constructs an
       XrmValue for the value string (by calling strlen to com-
       pute the size) and then calls XrmQPutResource, using a
       ``String'' representation type.  The value is stored in
       the database without modification.

       If database contains NULL, XrmPutLineResource creates a
       new database and returns a pointer to it.  XrmPutLineRe-
       source adds a single resource entry to the specified
       database.  The line must be in valid ResourceLine format
       (see section 15.1).  The string is parsed in the locale of
       the database.  If the ResourceName is not in the Host
       Portable Character Encoding the result is implementation
       dependent.  Note that comment lines are not stored.

SEE ALSO
       XrmGetResource(3X11), XrmInitialize(3X11), XrmMerge-
       Databases(3X11), XrmUniqueQuark(3X11)
       Xlib - C Language X Interface







X Version 11                Release 5                           2