kv_parallel_scan_iterator_next

#include <kvstore.h>

kv_error_t
kv_parallel_scan_iterator_next_key(
                     kv_parallel_scan_iterator_t *iterator,
                     const kv_key_t **key)

イテレータの次のキーを返します。別のキーが存在する場合、この関数はKV_SUCCESSを返し、keyパラメータが移入されます。キーがなくなると、戻り値はKV_NO_SUCH_OBJECTになります。戻り値がKV_SUCCESSまたはKV_NO_SUCH_OBJECT以外の場合、操作は失敗しています。

パラメータ

iterator

iteratorパラメータは、イテレータへのハンドルです。これは、ストアの複数の読取りを実行する関数(kv_multi_get()など)のいずれかを使用して割り当てられます。これは、kv_release_iterator()を使用して解放されます。
key

keyパラメータは、次のキーへのポインタのコピー先であるメモリーを参照します。

このキー構造は解放しないでください。ここで使用されるリソースは、イテレータが解放されるときに解放されます。