XrmMergeDatabases(3X11)                   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 des-
     tination database.  This function is used to combine data-
     bases (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 speci-
     fied 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 speci-
     fied database in the specified file.  The file is an ASCII
     text file that contains lines in the format that is accepted
     by XrmPutLineResource.



XWIN 3.0               Last change: 9/1/88                 .ie t

XrmMergeDatabases(3X11)                   XrmMergeDatabases(3X11)



     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









































XWIN 3.0               Last change: 9/1/88                 .ie t

XrmMergeDatabases(3X11)                   XrmMergeDatabases(3X11)























































XWIN 3.0               Last change: 9/1/88                 .ie t