kv_result_get_previous_version()

#include <kvstore.h>

kv_error_t 
kv_result_get_previous_version(const kv_operation_results_t *res,
                               kv_int_t index,
                               const kv_version_t **version) 

複数ステップの操作シーケンスとしてのPUT操作の実行前に存在していた値のバージョンを返します。以前のバージョンが存在するのは、操作内に指定した索引に、kv_create_put_with_options_op()によって作成されたPUT操作が含まれ、その関数のreturn_infoパラメータがKV_RETURN_VALUE_ALLまたはKV_RETURN_VALUE_VERSIONである場合のみです。

indexパラメータが範囲外の場合、この関数はKV_NO_SUCH_OBJECTを返します。

パラメータ

• res

  resパラメータは、調査する以前のバージョンが含まれる操作結果リストです。

• index

  indexパラメータは、取得する情報が保持されている結果リスト内の索引です。

• version

  versionパラメータは、以前のバージョンのコピー先となるメモリーを参照します。kv_release_version()を使用して、この値によって使用されるリソースを解放します。

  以前のバージョンを戻すように構成されているPUT操作によって索引付き結果が生成されなかった場合、このパラメータはNULLになります。

関連項目

• データ操作および関連関数