Deleting a root

#include "btree.h"

int btdelr(BTA* btact, char* root);

The btdelr function deletes the named root within the file associated with the btact context pointer. The target root name for deletion, a character string, is passed via the pointer in root. If the deletion of the target root is successful, btdelr returns zero.

All blocks owned by the target root are deleted, and returned to the free list. Whether or not the target root is deleted, the current root is left unchanged.

A non-zero return from btdelr indicates an error occurred during the root delete process. It is considered an error to attempt to delete the current root.