X Version 11 (1 September 1988) XrmMergeDatabases(XS)
NAME
XrmMergeDatabases, XrmGetFileDatabase, XrmPutFileDatabase,
XrmGetStringDatabase - 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;
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 XrmMergeDatabases 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 XrmGetFileDatabase 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
XrmPutLineResource. If it cannot open the specified file,
XrmGetFileDatabase returns NULL.
The XrmPutFileDatabase function stores a copy of the
specified database in the specified file. The file is an
ASCII text file that contains lines in the format that is
accepted by XrmPutLineResource.
The XrmGetStringDatabase function creates a new database and
stores the resources specified in the specified null-
terminated string. XrmGetStringDatabase is similar to
XrmGetFileDatabase 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
XrmPutLineResource.
SEE ALSO
XrmGetResource(XS), XrmInitialize(XS), XrmPutResource(XS),
XrmUniqueQuark(XS)
Xlib - C Language X Interface
(printed 2/12/90) (1 September 1988) XrmMergeDatabases(XS)