Initialising the B Tree library

#include "btree.h"

int btinit(void);

The btinit function initialises the B Tree library. It must be invoked before any other B Tree routine. Failure to do so will result in strange errors.

Calling btinit more than once in the execution lifetime of the B Tree library will cause it to return an error (QINERR). btinit also checks that the block size, in bytes, of the B Tree library is a power of two. An error return will result for non-conformant block sizes. Successful initialisation is indicated by a return value of zero.