更新日期：2024年09月11日
智能大对象的 GBase 8s ESQL/C API 允许应用程序就像访问操作系统文件一样访问
智能大对象。
不适合内存的智能大对象不必被读入文件，
然后从文件中访问；
它可以一次访问一个。
GBase 8s ESQL/C 应用程序通过下表中的 GBase 8s ESQL/C 库函数访问智能大对象。
ESQL/C 函数
描述
请参阅
ifx_lo_alter()
更改现有智能大对象的
存储特征
ifx_lo_alter() 函数
ifx_lo_close()
关闭打开的智能大对象
ifx_lo_close() 函数
ifx_lo_col_info()
检索 LO 特定结构中的
列级别存储特征
ifx_lo_col_info() 函数
ifx_lo_copy_to_file()
将智能大对象复制到操
作系统文件中
ifx_lo_copy_to_file()
函数
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 207 -
ESQL/C 函数
描述
请参阅
ifx_lo_copy_to_lo()
将操作系统文件复制到
打开的智能大对象中
ifx_lo_copy_to_lo() 函
数
ifx_lo_create()
创建智能大对象的 IO
指针结构
ifx_lo_create() 函数
ifx_lo_def_create_spec()
分配 LO 特定结构并将
它的字段初始化为空值
ifx_lo_def_create_spec(
) 函数
ifx_lo_filename()
返回生成的文件名，
给定
一个 LO 指针结构和一个文
件规范
ifx_lo_filename() 函数
ifx_lo_from_buffer()
将指定数量的字节从用
户定义的缓冲区复制到智能
大对象中
ifx_lo_from_buffer() 函
数
ifx_lo_open()
打开现有的智能大对象
ifx_lo_open() 函数
ifx_lo_read()
从打开的智能大对象中
读取指定字节数
ifx_lo_read() 函数
ifx_lo_readwithseek()
在打开的智能大对象中
寻找指定位置，
并读取指定的
字节数
ifx_lo_readwithseek()
函数
ifx_lo_release()
释放提交到临时智能大
对象的资源
ifx_lo_release() 函数
ifx_lo_seek()
在打开的智能大对象中
设置下一个读或写的搜索位
置
ifx_lo_seek() 函数
ifx_lo_spec_free()
释放分配到 LO 特定结
构的资源
ifx_lo_spec_free() 函数
ifx_lo_specget_estbytes()
获取智能大对象的建立
大小（以字节为单位）
ifx_lo_specget_estbytes
() 函数
ifx_lo_specget_extsz()
获取智能大对象的分配
extent 大小
ifx_lo_specget_extsz()
函数
ifx_lo_specget_flags()
获取智能大对象的创建
时间标志
ifx_lo_specget_flags()
函数
ifx_lo_specget_maxbytes()
获取智能大对象的最大
大小
ifx_lo_specget_maxbytes
() 函数
ifx_lo_specset_sbspace()
获取智能大对象的
ifx_lo_specget_sbspace(
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 208 -
ESQL/C 函数
描述
请参阅
sbspace 名称t
) 函数
ifx_lo_specset_estbytes()
设置智能大对象的估计
大小（以字节为单位）
ifx_lo_specset_estbytes
() 函数
ifx_lo_specset_extsz()
设置智能大对象的分配
extent 大小
ifx_lo_specset_extsz()
函数
ifx_lo_specset_flags()
设置智能大对象的创建
时间标志
ifx_lo_specset_flags()
函数
ifx_lo_specset_maxbytes()
设置智能大对象的最大
大小
ifx_lo_specset_maxbytes
() 函数
ifx_lo_specset_sbspace()
设置智能大对象的
sbspace 名称t
ifx_lo_specset_sbspace(
) 函数
ifx_lo_stat()
获取打开的智能大对象
的状态信息
ifx_lo_stat() 函数
ifx_lo_stat_atime()
返回智能大对象的上一
次访问时间
ifx_lo_stat_atime() 函
数
ifx_lo_stat_cspec()
返回智能大对象的存储
特征
ifx_lo_stat_cspec() 函
数
ifx_lo_stat_ctime()
返回智能大对象的状态
上一次更改的时间
ifx_lo_stat_ctime() 函
数
ifx_lo_stat_free()
释放分配到 LO 状态结
构的资源
ifx_lo_stat_free() 函数
ifx_lo_stat_mtime_sec()
返回最后一次修改智能
大对象的时间（以秒为单位）
ifx_lo_stat_mtime_sec()
函数
ifx_lo_stat_refcnt()
返回智能大对象的引用
次数
ifx_lo_stat_refcnt() 函
数
ifx_lo_stat_size()
返回智能大对象的大小
ifx_lo_stat_size() 函数
ifx_lo_tell()
返回打开智能大对象当
前搜索位置
ifx_lo_tell() 函数
ifx_lo_to_buffer()
将指定数量的字节从智
能大对象复制到用户定义的
缓冲区中
ifx_lo_to_buffer() 函数
ifx_lo_truncate()
将智能大对象截断到特
定的偏移量
ifx_lo_truncate() 函数
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 209 -
ESQL/C 函数
描述
请参阅
ifx_lo_write()
将一个指定数量的字节
写入到一个打开的智能大对
象中
ifx_lo_write() 函数
ifx_lo_writewithseek()
在打开的智能大对象中
寻找指定的位置并写入指定
的字节数
ifx_lo_writewithseek()
函数
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 210 -
sword GCIDateTimeGetTimeZoneOffset (
void *hndl,
GCIError *errhp,
const GCIDateTime *datetime,
sb1 *hour,
sb1 *min
);
获取日期时间值的时区（小时、分钟）部分。如果给定的日期时间不包含时间信息，则此
函数返回错误。
参数
输入
/输出
hndl
输入
用户会话句柄或环境句柄
errhp
输入/输出
错误信息句柄，该接口调用失败时，错误信息会存在该句柄上
datetime
输入
指向 GCIDateTime 描述符的指针
hour
输出
检索到的时区小时值
min
输出
检索到的时区分钟值
如果执行成功，返回 GCI_SUCCESS，否则返回 GCI_ERROR。