XrmMergeDatabases(3) XLIB FUNCTIONS XrmMergeDatabases(3)

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

X Version 11 libX11 1.8.10 XrmMergeDatabases(3)