Changing the current root

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