Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XrmMergeDatabases(3)		 XLIB FUNCTIONS 	    XrmMergeDatabases(3)

NAME
     XrmMergeDatabases,  XrmCombineDatabase,  XrmCombineFileDatabase - merge re-
     source 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  *tar-
	    get_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 XrmCom-
     bineDatabase 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 con-
     tains NULL, XrmCombineDatabase simply stores source_db in	it.   Otherwise,
     source_db	is  destroyed  by the merge, but the database pointed to by tar-
     get_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  dis-
     carded.   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.13 	    XrmMergeDatabases(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XrmCombineDatabase&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help