manpagez: man pages & more
man XrmCombineDatabase(3)
Home | html | info | man
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(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 data-
                 base 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 data-
       bases,  the  entry  in the source_db will replace the entry in the tar-
       get_db if override is True; otherwise, the entry in source_db  is  dis-
       carded.   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 modi-
       fied.


SEE ALSO

       XrmGetResource(3), XrmInitialize(3), XrmPutResource(3)
       Xlib - C Language X Interface



X Version 11                     libX11 1.6.9             XrmMergeDatabases(3)

xorg-libX11 1.6.9 - Generated Thu Oct 24 16:17:18 CDT 2019
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.