#include <kvstore.h> kv_error_t kv_iterator_next_key(kv_iterator_t *iterator, const kv_key_t **key)
Returns the iterator's next key. If another key exists, this
function returns KV_SUCCESS
, and the
key parameter is populated. If
there are no more keys, the return value is
KV_NO_SUCH_OBJECT
. If the return value is
something other than KV_SUCCESS
or
KV_NO_SUCH_OBJECT
, there was an operational
failure.
The iterator parameter is the handle to the iterator. It is allocated using one of functions that performs multiple reads of the store (such as kv_multi_get()). It is released using kv_release_iterator().