XrmMergeDatabases(3X) XrmMergeDatabases(3X)
NAME
XrmMergeDatabases, XrmGetFileDatabase,
XrmPutFileDatabase, XrmGetStringDatabase - manipulate
resource databases
SYNOPSIS
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
- 1 -
XrmMergeDatabases(3X) XrmMergeDatabases(3X)
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(3X11), XrmInitialize(3X11),
XrmPutResource(3X11), XrmUniqueQuark(3X11)
Xlib Programming Manual
- 2 -