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

dataSpecifies the database contents using a string. 

databaseSpecifies the database that is to be used. 

filenameSpecifies the resource database file name. 

source_dbSpecifies the resource database that is to be merged into the target database. 

stored_dbSpecifies the file name for the stored database. 

target_dbSpecifies 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.

If database is NULL, XrmDestroyDatabase 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