Creating a root

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