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バイトである必要があります。