XrmMergeDatabases(3X11)   XLIB FUNCTIONS  XrmMergeDatabases(3X11)


NAME
       XrmMergeDatabases, XrmCombineDatabase, XrmCombineFile-
       Database - merge resource databases

SYNTAX
       void XrmMergeDatabases(sourcedb, targetdb)
             XrmDatabase sourcedb, *targetdb;

       void XrmCombineDatabase(sourcedb, targetdb, override)
             XrmDatabase sourcedb, *targetdb;
             Bool override;

       void XrmCombineFileDatabase(filename, targetdb, override)
             char *filename;
             XrmDatabase *targetdb;
             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 source_db
       will replace the entry in the target_db (that is, it over-
       rides target_db).  If target_db contains NULL, XrmMerge-
       Databases 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 chang-
       ing values or types, regardless of the locales of the
       databases.  The locale of the target database is not modi-
       fied.

       The XrmCombineFileDatabase function merges the contents of
       a resource file into a database.  If the same specifier is



X Version 11                Release 5                           1

XrmMergeDatabases(3X11)   XLIB FUNCTIONS  XrmMergeDatabases(3X11)


       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 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), XrmPutRe-
       source(3X11)
       Xlib - C Language X Interface








































X Version 11                Release 5                           2