|
Purpose |
Closes the currently open database |
|
Old name |
#define dbclose db_close |
|
Syntax (CCOWN) |
void db_close(void) |
|
Syntax (DP4DBAPI) |
BOOLEAN dp4_db_close(DCONN * dconn) |
|
Description |
Closes the currently open database (db_close()) or the specified database (dp4_db_close()). All databases are closed automatically when a program terminates, but calling db_close() ensures that the user is correctly prompted to remove the log disk if logging to removable media. For the OWN API the current open database is the one determined by the global variable db_nr . For C programs LIBMAKE generates a call to db_close() in the function finish() unless you specify the #noinit toggle. For the DP4DBAPI version of the function the return value is TRUE if the function completes normally, and FALSE if the function encountered an error. Whatever the return value is, the DCONN handle is invalid upon return from dp4_db_close(). |
|
See also |