lld_read() 函数

此函数用于从当前位置开始读取大对象。

语法

API
mi_integer lld_read (io, buffer, bytes, error)

LLD_IO*                         io, 
void*                           buffer, 
mi_integer                      bytes, 
mi_integer*                     error); 
ESQL/C
int lld_read (LLD_IO* io, 
                        void* buffer, int bytes, 
                        int* error); 
io
指向先前通过调用 lld_open() 函数创建的 LLD_IO 结构的指针。
buffer
指向将数据读入的缓冲区的指针。该缓冲区的大小不得低于 bytes 参数中指定的字节数。
字节
要读取的字节数。
error
函数在其中返回错误代码的输出参数。

用途

调用此函数之前,必须通过调用 lld_open() 打开大对象并设置 LLD_RDONLY 或 LLD_RDWR 标志。lld_read() 函数将从当前位置开始进行读取。缺省情况下,打开大对象时,当前位置即为对象的开始位置。可以调用 lld_seek() 以更改当前位置。

返回码

如果成功,lld_read() 函数将返回它从大对象读取的字节数。

如果失败,对于 API 函数,将返回 MI_ERROR;而对于 ESQL/C 函数,将返回 -1

上下文

lld_open() 函数

lld_seek() 函数

lld_tell() 函数