XrmMergeDatabases(3X11)     X Version 11(Release 5)     XrmMergeDatabases(3X11)


NAME
      XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileDatabase - 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
      source_db Specifies the resource database that is to be merged into the
                target database.

      target_db 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 source_db will replace the entry in the target_db (that
      is, it overrides target_db).  If target_db contains NULL,
      XrmMergeDatabases simply stores source_db in it.  Otherwise, source_db is
      destroyed by the merge, but the database pointed to by target_db 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 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 source_db will replace the entry in the target_db if
      override is True; otherwise, the entry in source_db is discarded.  If
      target_db contains NULL, XrmCombineDatabase simply stores source_db in
      it.  Otherwise, source_db is destroyed by the merge, but the database
      pointed to by target_db 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
      discarded.  The file is parsed in the current locale.  If the file cannot


10/89                                                                    Page 1

XrmMergeDatabases(3X11)     X Version 11(Release 5)     XrmMergeDatabases(3X11)


      be read a zero status is returned; otherwise a nonzero status is
      returned.  If target_db contains NULL, XrmCombineFileDatabase creates and
      returns a new database to it.  Otherwise, the database pointed to by
      target_db 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(3X11), XrmInitialize(3X11), XrmPutResource(3X11)
      Xlib - C Language X Interface












































Page 2                                                                    10/89