#include "btree.h"
BTA* btopn(char* fid, int mode, int shared);
The btopn function will open an existing
B Tree file. The parameter fid must be
set to the name of the file to open. The
mode parameter determines if the B Tree
file can be updated. A value of zero indicates that updates
are allowed, a non-zero value will prohibit updates. The
parameter shared should be set to zero
to disallow shared access to the B Tree file, or non-zero to
allow shared access.
btopn will return a pointer to the BT
activation context for the newly opened file (BTA*), or NULL
in the case of an error. To determine the cause of an error,
invoke the btcerr
function.
If the B Tree index file has been successfully opened,
the default root is selected, and the file is ready for
further operations.