#include <kvstore.h> kv_error_t kv_iterator_next(kv_iterator_t *iterator, const kv_key_t **key, const kv_value_t **value)
Returns the iterator's next record. If another record exists, this
function returns KV_SUCCESS, and the
key and
value parameters are populated. If
there are no more records, 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().
The key parameter references memory in which a pointer to the next key is copied.
Note, you should not release this key structure. The resources used here will be released when the iterator is released.