kv_create_value()

#include <kvstore.h>

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

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

この関数は、kv_create_value_copy()とは異なり、関数に渡されたデータ・バッファの内容をコピーしません。したがって、この関数によって作成されたkv_value_t構造が解放されるまでは、これらのデータ・バッファを解放または変更しないようにする必要があります。

パラメータ

  • store

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

  • value

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

  • data

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

    ここで使用されるバッファはコピーされないことに注意してください。このメモリーを使用する構造が解放されるまでは、メモリーを解放または変更しないでください。

  • data_len

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