lq-text: LQTp_CreateEmptyKeyValueDatabase

LIBRARY char * LQTp_CreateEmptyKeyValueDatabase (db, Directory, prefix) t_LQTEXT_Database *db; char *Directory; char *prefix;

Purpose

Some versions of dbm or ndbm provided with various Unix systems do not automatically create a new DBM file, even when asked to; it is necessary to create the file with the open(2) or creat(2) system calls. The original Unix dbm library was like this.

This function creates the necessary files, in the given Directory; the files will have names beginning with the given Prefix, and depending on the version of ndbm in use, may have a suffix such as .db; BSD db uses a single file, but most other implementations use two, one called Prefix.dir and one called Prefix.pag.

This routine is called automatically by LQT_Open­Key­Value­Database when necessary, but is made available for general use for convenience.

Bugs

LQTp_Create­Empty­Key­Value­Database should be in liblqutil instead.

See Also: