Museum

     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



     Licensed material--property of copyright holder(s)         Page 1

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



          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 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





































     Licensed material--property of copyright holder(s)         Page 2