1XrmMergeDatabases(3)            XLIB FUNCTIONS            XrmMergeDatabases(3)
2
3
4

NAME

6       XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileDatabase - merge
7       resource databases
8

SYNTAX

10       #include <X11/Xresource.h>
11
12       void XrmMergeDatabases(XrmDatabase source_db, XrmDatabase *target_db);
13
14       void XrmCombineDatabase(XrmDatabase source_db, XrmDatabase *target_db,
15              Bool override);
16
17       Status XrmCombineFileDatabase(char *filename, XrmDatabase *target_db,
18              Bool override);
19

ARGUMENTS

21       source_db Specifies the resource database that is to be merged into the
22                 target database.
23
24       target_db Specifies the resource database into which the source data‐
25                 base is to be merged.
26
27       filename  Specifies the resource database file name.
28
29       override  Specifies whether source entries override target ones.
30

DESCRIPTION

32       Calling the XrmMergeDatabases function is equivalent to calling the
33       XrmCombineDatabase function with an override argument of True.
34
35       The XrmCombineDatabase function merges the contents of one database
36       into another.  If the same specifier is used for an entry in both data‐
37       bases, the entry in the source_db will replace the entry in the tar‐
38       get_db if override is True; otherwise, the entry in source_db is dis‐
39       carded.  If target_db contains NULL, XrmCombineDatabase simply stores
40       source_db in it.  Otherwise, source_db is destroyed by the merge, but
41       the database pointed to by target_db is not destroyed.  The database
42       entries are merged without changing values or types, regardless of the
43       locales of the databases.  The locale of the target database is not
44       modified.
45
46       The XrmCombineFileDatabase function merges the contents of a resource
47       file into a database.  If the same specifier is used for an entry in
48       both the file and the database, the entry in the file will replace the
49       entry in the database if override is True; otherwise, the entry in the
50       file is discarded.  The file is parsed in the current locale.  If the
51       file cannot be read, a zero status is returned; otherwise, a nonzero
52       status is returned.  If target_db contains NULL, XrmCombineFileDatabase
53       creates and returns a new database to it.  Otherwise, the database
54       pointed to by target_db is not destroyed by the merge.  The database
55       entries are merged without changing values or types, regardless of the
56       locale of the database.  The locale of the target database is not modi‐
57       fied.
58

SEE ALSO

60       XrmGetResource(3), XrmInitialize(3), XrmPutResource(3)
61       Xlib - C Language X Interface
62
63
64
65X Version 11                     libX11 1.6.7             XrmMergeDatabases(3)
Impressum