XrmMergeDatabases(3X11)              SysV              XrmMergeDatabases(3X11)



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(3X11), XrmInitialize(3X11), XrmPutResource(3X11),
     XrmUniqueQuark(3X11)
     Xlib - C Language X Interface