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(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