ifx_lo_write() 函数将指定的字节数写到打开的智能大对象。
语法
mint ifx_lo_write(LO_fd, buf, nbytes, error)
mint LO_fd;
char *buf;
mint nbytes;
mint *error;
LO_fd
表示要写到其的智能大对象的 LO 文件描述符。
buf
指向包含该函数写到智能大对象的数据的缓冲区的指针。
nbytes
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 808 -
写到智能大对象的字节数。此值的最小长度为 0,且必须小于 2 GB。
error
指向包含 ifx_lo_write() 设置的错误代码的 mint 的指针。
用法
ifx_lo_write() 函数将 nbytes 的数据写到 LO_fd 文件描述符标识的智能大对象。在
LO_fd 的当前搜寻位置开始写。您可使用 ifx_lo_tell() 函数来取得当前的搜寻位置。
该函数从 buf 指向的用户定义的缓冲区取得数据。
buf 缓冲区的大小必须小于 2 GB。
如果数据库服务器将少于 nbytes 的数据写到智能大对象,
则 ifx_lo_write() 函数返回
它写了的字节数,并设置 error 值来指向指示未完成的写操作的原因的值。当 sbspace 用
尽空间时,可发生此情况。
返回代码
>=0
函数已从 buf 字符缓冲区写到打开的智能大对象的字节数。
-1
函数不成功;请检测 error 的详尽错误代码。