kv_result_get_previous_value()

#include <kvstore.h>

kv_error_t 
kv_result_get_previous_value(const kv_operation_results_t *res,
                             kv_int_t index,
                             const kv_value_t **value) 

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

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

パラメータ

• res

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

• index

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

• value

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

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

関連項目

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