XrmMergeDatabases(3X11)       SDK X11 R4.11MU05      XrmMergeDatabases(3X11)


NAME
       XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileDatabase - 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 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 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)