NAME

       XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileDatabase - merge resource databases

SYNTAX

       #include <X11/Xresource.h>

       void XrmMergeDatabases(XrmDatabase source_db, XrmDatabase *target_db);

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

       Status   XrmCombineFileDatabase(_Xconst   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 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 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(3), XrmInitialize(3), XrmPutResource(3)
       Xlib - C Language X Interface