Setting the position within a B Tree index

#include "btree.h"

int btpos(BTA* btact, int pos);

The btpos function sets the position in the current root in the file associated with the btact context pointer. The desired position is indicated by the pos; a value of 1 positions before the first key in the index, a value of 2 will position after the last key in the index. These values correspond to the B Tree constants ZSTART and ZEND, respectively.

Following a call to btpos, calls to bnxtky and bprvky may be made to return successive or previous keys.

btpos returns zero to indicate success, otherwise the error code if an error was encountered.