XrmMergeDatabases(3) XLIB FUNCTIONS XrmMergeDatabases(3)

NAME
       XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileDatabase - merge
       resource databases

SYNTAX
       #include 

       void XrmMergeDatabases(XrmDatabase sourcedb, XrmDatabase *targetdb);

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

       Status XrmCombineFileDatabase(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 data‐
                 base 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 specifier is used for an entry in both data‐
       bases, the entry in the sourcedb will replace the entry in the tar‐
       getdb if override is True; otherwise, the entry in sourcedb is dis‐
       carded.  If targetdb contains NULL, XrmCombineDatabase simply stores
       sourcedb in it.  Otherwise, sourcedb is destroyed by the merge, but
       the database pointed to by targetdb 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 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 targetdb contains NULL, XrmCombineFileDatabase
       creates and returns a new database to it.  Otherwise, the database
       pointed to by targetdb 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 modi‐
       fied.

SEE ALSO
       XrmGetResource(3), XrmInitialize(3), XrmPutResource(3)
       Xlib - C Language X Interface



X Version 11                     libX11 1.6.5             XrmMergeDatabases(3)