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

NAME

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

SYNTAX

10       void XrmMergeDatabases(XrmDatabase source_db, *target_db);
11
12       void XrmCombineDatabase(XrmDatabase source_db, XrmDatabase *target_db);
13
14       Status XrmCombineFileDatabase(char *filename, XrmDatabase *target_db,
15              Bool override);
16

ARGUMENTS

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

DESCRIPTION

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

SEE ALSO

57       XrmGetResource(3X11), XrmInitialize(3X11), XrmPutResource(3X11)
58       Xlib - C Language X Interface
59
60
61
62X Version 11                     libX11 1.0.3          XrmMergeDatabases(3X11)
Impressum