XrmMergeDatabases(3X)                       XrmMergeDatabases(3X)



NAME
     XrmMergeDatabases, XrmGetFileDatabase, XrmPutFileDatabase,
     XrmGetStringDatabase,    XrmDestroyDatabase   -   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;

     void XrmDestroyDatabase (data)
     XrmDatabase database;

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 de-
     faults 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
     application's current 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 separat-
     ed by a newline character in the form accepted by
     XrmPutLineResource.

     The XrmDestroyDatabase destroys the specified database.  If
     database is NULL, XrmDestroyDatabase returns immediately.



November, 1990                                                  1

XrmMergeDatabases(3X)                       XrmMergeDatabases(3X)



   Arguments
     These functions accept the following arguments:

     data    Specifies the database contents using a string.

     database
             Specifies the database to be used.

     filename
             Specifies the resource database filename.

     source-db
             Specifies the resource database to be merged into
             the target database.

     stored-db
             Specifies the filename for the stored database.

     target-db
             Specifies a pointer to the resource database into
             which the source database is to be merged.

SEE ALSO
     XrmGetResource(3X), XrmInitialize(3X),
     XrmPutResource(3X), XrmUniqueQuark(3X)

     Xlib - C Language Interface





























2                                                  November, 1990