XrmCombineFileDatabase()XrmCombineFileDatabase()NameXrmCombineFileDatabase – combine the contents of a resource file and a
resource database.
Synopsis
Status XrmCombineFileDatabase(filename, target_db, override)
char *filename;
XrmDatabase *target_db;
Bool override;
Arguments
filename Specifies the name of the resource file.
target_db Specifies the address of the resource database with which the
resource file is to be combined.
override Specifies whether resources from the file should override
matching resources in the database.
Returns
Zero on failure, non-zero on success.
Availability
Release 5 and later.
DescriptionXrmCombineFileDatabase() merges the contents of a resource file into a
database. If the same resource specifier is used for an entry in both
the file and the database, the entry in the file will replace the entry
in the database if override is True; otherwise, the entry in the file
is discarded.
If target_db points to a NULL database, XrmCombineFileDatabase() cre‐
ates a new database, reads the file into it and stores this new data‐
base at the location pointed to by
target_db. Otherwise, the database pointed to by target_db is not
destroyed by the merge.
If the file cannot be read a zero status is returned; otherwise a non-
zero status is returned.
The file is parsed in the current locale. The database entries are
merged without changing values or types, regardless of the locale of
the database, and the locale of the target database is not modified.
See AlsoXrmCombineDatabase(), XrmMergeDatabases().
Xlib - Resource Manager XrmCombineFileDatabase()