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

FreeBSD Manual Pages

  
 
  

home | help
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(_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 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.12		  XrmMergeDatabases(3)

NAME | SYNTAX | ARGUMENTS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XrmMergeDatabases&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help