kv_lob_read()
#include <kvstore.h>
kv_int_t
kv_lob_read(kv_lob_handle_t *handle,
kv_long_t offset,
kv_int_t num_bytes_to_read,
unsigned char *buffer);
ストアからバッファへのLOBの単一のチャンクまたは一部の読込みを実行します。kv_lob_handle_t
は、(kv_lob_get_for_read()を使用して)読取り用にオープンされている必要があります。そうでない場合、KV_INVALID_ARGUMENT
が返されます。そうでない場合は、読み取られたバイト数が返されます。LOBの終わりは、戻り値0
で示されます。負の戻り値は、読取り時のエラーを示します
パラメータ
-
handle
handleパラメータは、読取りの実行に使用するLOBハンドルです。これは、kv_lob_get_for_read()を使用して作成されている必要があります。
-
offset
offsetパラメータは、この読取りを開始するLOBへのオフセットです。
-
num_bytes_to_read
num_bytes_to_readパラメータは、LOBから読み取るバイト数です。
-
buffer
bufferパラメータは、LOBチャンクの格納先となるユーザー指定のバッファです。このバッファのサイズは、少なくともnum_bytes_to_readバイトである必要があります。
関連項目