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(_Xconst char *filename, XrmDatabase *tar‐
18              get_db, 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.8.7             XrmMergeDatabases(3)
Impressum