This manual page is for Mac OS X version 10.6.3

Reading manual pages

XrmMergeDatabases(3)                           XLIB FUNCTIONS                           XrmMergeDatabases(3)



NAME
       XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileDatabase - merge resource databases

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

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

       Status XrmCombineFileDatabase(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.

       override  Specifies whether source entries override target ones.

DESCRIPTION
       Calling the XrmMergeDatabases function is equivalent to calling the XrmCombineDatabase function with
       an override argument of True.

       The XrmCombineDatabase function merges the contents of one database into another.  If the same speci-fier specifier
       fier 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 tar-get target
       get 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 the 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



X Version 11                                    libX11 1.2.1                            XrmMergeDatabases(3)