kv_parallel_scan_iterator

kv_parallel_scan_iterator_next()
Prev	Chapter 3. Data Operation Functions	Next

kv_parallel_scan_iterator_next()

#include <kvstore.h>

kv_error_t 
kv_parallel_scan_iterator_next(kv_parallel_scan_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.

Parameters

iterator

The iterator parameter is the handle to the iterator. It is allocated using kv_parallel_store_iterator(). It is released using kv_release_parallel_scan_iterator().

key

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.

value

The value parameter references memory in which a pointer to the next value is copied.

Note, you should not release this value structure. The resources used here will be released when the iterator is released.

Prev	Up	Next
kv_operations_size()	Home	kv_parallel_scan_iterator_next_key()