kv_create_value_copy()

#include <kvstore.h>

kv_error_t 
kv_create_value_copy(kv_store_t *store,
                     kv_value_t **value,
                     const unsigned char *data,
                     int data_len) 

key/valueストアに値を作成します。この構造によって使用されるリソースを解放するには、kv_release_value()を使用します。

この関数は、kv_create_value()とは異なり、関数に渡されたデータ・バッファの内容をコピーします。そのため、バッファは、アプリケーションで必要などのような形式であれ、解放または変更し、再利用できます。

パラメータ

  • store

    storeパラメータは、値が格納されるストアに対するハンドルです。ストア・ハンドルは、kv_open_store()を使用して取得されます。

  • value

    valueパラメータは、割り当てられた値へのポインタのコピー先であるメモリーを参照します。

  • data

    dataパラメータは、値に含めるデータが含まれるバッファです。

    ここで使用されるバッファはコピーされることに注意してください。このメモリーの内容はkv_value_t構造が所有するメモリーにコピーされるため、必要に応じてこのメモリーを解放または変更できます。

  • data_len

    data_lenパラメータは、データ・バッファのサイズを示します。