#include "btree.h"
int bupdky(BTA* btact, char* key, BTint value);
The bupdky function updates the value of
an existing key in the current root of the file associated
with the btact context pointer. The
key, a character string, is passed via the pointer in
key. The new value is passed via
value. value is
declared as a BTint, which is normally a typedef for
int, but with Large File Support will be
a typedef for long long.
If the key does not exist, bupdky returns
the error code QNOKEY.
If bupdky is called with a
key value of NULL, the update operation
will act against the current key, as selected by
bfndky, bnxtky or
bprvky operations. This capability is
designed to allow update of a duplicate key, presumably based
on other, application managed, attributes.
bupdky returns zero to indicate a
successful update, error code otherwise.
