kv_put()

#include <kvstore.h>

kv_error_t 
kv_put(kv_store_t *store,
       const kv_key_t *key,
       const kv_value_t *value,
       kv_version_t **new_version)

key/valueペアをストアに書き込み、必要に応じて挿入または上書きします。

これは、大半のPUTオプションにデフォルト値を使用する、単純なバージョンの関数です。デフォルト以外の値を使用できる完全なバージョンの場合は、kv_put_with_options()を使用します。

パラメータ

  • store

    storeパラメータは、key/valueペアを書き込むストアへのハンドルです。

  • key

    keyパラメータは、ストアに書き込むキーです。これは、kv_create_key()またはkv_create_key_from_uri()を使用して作成します。

  • value

    valueパラメータは、ストアに書き込む値です。これは、kv_create_value()を使用して作成されます。

  • new_version

    new_versionパラメータは、key/valueペアの新しいバージョン情報のコピー先となるメモリーを参照します。この関数によってゼロ以外の戻りコードが生成される場合、このポインタはNULLになります。

    バージョン・データ構造で使用されるリソースは、kv_release_version ()を使用して解放します。