#include "btree.h"
int btchgr(BTA* btact, char* root);
The btchgr function changes the current
root within the file associated with the
btact context pointer. The target root
name, a character string, is passed via the pointer in
root. If the switch to the target root
is successful, btchgr returns zero.
On successful change to the target root, on return from
btchgr, the target root will have been
made current. If the root could not be switched, the current
root is unchanged.
A non-zero return from btchgr indicates
an error occurred during the root change process.