XrmMergeDatabases(XS)    X Version 11 (Release 5)      XrmMergeDatabases(XS)
                                6 January 1993


 Name

    XrmMergeDatabases - merge resource databases

 Syntax


    void XrmMergeDatabases(source_db, target_db)
          XrmDatabase source_db, *target_db;

    void XrmCombineDatabase(source_db, target_db, override)
          XrmDatabase source_db, *target_db;
          Bool override;

    void XrmCombineFileDatabase(filename, target_db, override)
          char *filename;
          XrmDatabase *target_db;
          Bool override;


 Arguments


    sourcedb  Specifies the resource database that is to be merged into the
               target database.

    targetdb  Specifies the resource database into which the source database
               is to be merged.

    filename   Specifies the resource database file name.

 Description

    The XrmMergeDatabases function merges the contents of one database into
    another.  If the same specifier is used for an entry in both databases,
    the entry in the sourcedb will replace the entry in the targetdb (that
    is, it overrides targetdb).  If targetdb contains NULL, XrmMergeData-
    bases simply stores sourcedb in it.  Otherwise, sourcedb is destroyed
    by the merge, but the database pointed to by targetdb is not destroyed.
    The database entries are merged without changing values or types, regard-
    less of the locales of the databases.  The locale of the target database
    is not modified.

    The XrmCombineDatabase function merges the contents of one database into
    another.  If the same specifier is used for an entry in both databases,
    the entry in the sourcedb will replace the entry in the targetdb if
    override is True; otherwise, the entry in sourcedb is discarded.  If
    targetdb contains NULL, XrmCombineDatabase simply stores sourcedb in
    it.  Otherwise, sourcedb is destroyed by the merge, but the database
    pointed to by targetdb is not destroyed.  The database entries are
    merged without changing values or types, regardless of the locales of the
    databases.  The locale of the target database is not modified.

    The XrmCombineFileDatabase function merges the contents of a resource
    file into a database.  If the same specifier is used for an entry in both
    the file and the database, the entry in the file will replace the entry
    in the database if override is True; otherwise, the entry in file is dis-
    carded.  The file is parsed in the current locale.  If the file cannot be
    read a zero status is returned; otherwise a nonzero status is returned.
    If targetdb contains NULL, XrmCombineFileDatabase creates and returns a
    new database to it.  Otherwise, the database pointed to by targetdb is
    not destroyed by the merge.  The database entries are merged without
    changing values or types, regardless of the locale of the database.  The
    locale of the target database is not modified.

 See also

    XrmGetResource(XS), XrmInitialize(XS), XrmPutResource(XS)
    Xlib - C Language X Interface