xrmputfiledatabase(3x11) [ultrix man page]

XrmMergeDatabases(3X11) 					     MIT X11R4						   XrmMergeDatabases(3X11)

Name
       XrmMergeDatabases, XrmGetFileDatabase, XrmPutFileDatabase, XrmGetStringDatabase, XrmDestroyDatabase - manipulate resource databases

Syntax
       void XrmMergeDatabases(source_db, target_db)
	  XrmDatabase source_db, *target_db;

       XrmDatabase XrmGetFileDatabase(filename)
	  char *filename;

       void XrmPutFileDatabase(database, stored_db)
	  XrmDatabase database;
	  char *stored_db;

       XrmDatabase XrmGetStringDatabase(data)
	  char *data;

       void XrmDestroyDatabase(database)
	  XrmDatabase database;

Arguments
       data	 Specifies the database contents using a string.

       database  Specifies the database that is to be used.

       filename  Specifies the resource database file name.

       source_db Specifies the resource database that is to be merged into the target database.

       stored_db Specifies the file name for the stored database.

       target_db Specifies a pointer to the resource database into which the source database is to be merged.

Description
       The function merges the contents of one database into another.  It may overwrite entries in the destination database.  This function is
       used to combine databases (for example, an application specific database of defaults and a database of user preferences).  The merge is
       destructive; that is, the source database is destroyed.

       The function opens the specified file, creates a new resource database, and loads it with the specifications read in from the specified
       file.  The specified file must contain lines in the format accepted by If it cannot open the specified file, returns NULL.

       The function stores a copy of the specified database in the specified file.  The file is an ASCII text file that contains lines in the for-
       mat that is accepted by

       The function creates a new database and stores the resources specified in the specified null-terminated string.	is similar to except that
       it reads the information out of a string instead of out of a file.  Each line is separated by a new-line character in the format accepted
       by

       If database is NULL, returns immediately.

See Also
       XrmGetResource(3X11), XrmInitialize(3X11), XrmPutResource(3X11), XrmUniqueQuark(3X11)
       X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys

															   XrmMergeDatabases(3X11)

XrmMergeDatabases(3X11) 					  XLIB FUNCTIONS					   XrmMergeDatabases(3X11)

NAME

       XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileDatabase - merge resource databases

SYNTAX

       void XrmMergeDatabases(source_db, target_db)
	     XrmDatabase source_db, *target_db;

       void XrmCombineDatabase(source_db, target_db, override)
	     XrmDatabase source_db, *target_db;
	     Bool override;

       Status XrmCombineFileDatabase(filename, target_db, override)
	     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 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 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 target_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, regard-
       less of the locale of the database.  The locale of the target database is not modified.

SEE ALSO

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

X Version 11							    Release 6.6 					   XrmMergeDatabases(3X11)