#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 change process. It is
considered an error to attempt to delete the current
root.