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