XrmMergeDatabases(3X11
X)Version 11 (ReleaseX4
r)
mMergeDatabases(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 XrmMergeDatabases function merges the contents of one
       database into another.  It may overwrite entries in the


  Page 1                                          (printed 8/30/91)

  XrmMergeDatabases(3X11
X)Version 11 (ReleaseX4
r)
mMergeDatabases(3X11)



       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)
       Xlib - C Language X Interface











  Page 2                                          (printed 8/30/91)