lld_read() 函数

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

语法

mi_integer lld_read (io, buffer, bytes, error)

LLD_IO*                         io, 
void*                           buffer, 
mi_integer                      bytes, 
mi_integer*                     error); 

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() 函数