NAME

XrmCombineFileDatabase — 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

filenameSpecifies the name of the resource file. 

target_dbSpecifies the address of the resource database with which the resource file is to be combined. 

overrideSpecifies 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. 

DESCRIPTION

XrmCombineFileDatabase() 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() creates a new database, reads the file into it and stores this new database 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 ALSO

XrmCombineDatabase(), XrmMergeDatabases(). 

Xlib Reference Manual