返回首页

gbase数据、南大通用产品文档:GBase8sifx_lo_write() 函数

更新日期:2024年09月11日

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 的详尽错误代码。

gbase_real_query ............................ 38

orato8a 安装包以tar.bz2 的压缩形式提供。例如:orato8a_26794_Redhat6.2_x86_64.
tar.bz2。
说明
该安装包文件名各部分的具体含义如下:

orato8a:代表工具的名称;

26794:代表该工具的版本号;

Redhat6.2:代表该工具运行的操作系统为Red hat 6.2;

x86_64:代表该工具是一个运行在64 位操作系统下的工具。