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 ()を使用して解放します。
関連項目