gbase数据、南大通用产品文档：GBase8sifx_lo_to_buffer() 函数

ifx_lo_to_buffer() 函数将指定的字节数从智能大对象复制至用户定义的缓冲区内。

语法
mint ifx_lo_to_buffer(LO_ptr, size, buf_ptr)
ifx_lo_t *LO_ptr;

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 805 -

mint size;
char **buf_ptr;

mint error;
LO_ptr
您想要从其复制数据的智能大对象的 LO-pointer 结构。
size
标识要从智能大对象复制的字节数的 mint。
buf_ptr
指向您想要将数据复制到的用户定义的缓冲区的加倍间接指针。
error
包含保存 ifx_lo_to_buffer() 设置的错误代码的 mint 的地址。

用法

ifx_lo_to_buffer() 函数从 LO_ptr 参数标识的智能大对象复制字节，
最多为 size 参数
指定的大小。来自智能大对象的读操作起始于零字节偏移量。如果该智能大对象小于 size
值，则 ifx_lo_to_buffer() 仅复制智能大对象中的字节数。如果该智能大对象包含多于 size
的字节，则 ifx_lo_to_buffer() 函数最多仅复制 size 字节至用户定义的缓冲区内。

当 buf_ptr 为 NULL 时，ifx_lo_to_buffer() 为用户定义的缓冲区分配内存。否则，
该函数假定您已分配了 buf_ptr 标识的内存。

返回代码
0
buf_ptr 标识的从智能大对象复制到用户定义的缓冲区的字节数。
-1
函数不成功。

任务列表中选择任务，
点击
“查看任务”
，
可以查看任务的详细信息或者任务报
告，如下图：

图 4-16-1 任务详情
未结束的任务，将会显示任务详情，详情中将展现任务的基本配置信息，
和迁移的基本信息；
已完成的任务（已完成是指：状态为已完成或者已停止，其它状态均为未
完成）将会显示任务报告，其中会给出相应的耗时以及结果信息等报告内容，

GBase Mingration Toolkit 迁移工具手册

- 18 -

南大通用数据技术股份有限公司
如下图：

图 4-16-2 任务报告
点击该页面的“详情”按钮查看任务中具体迁移对象的详情，如下图：



GBase Mingration Toolkit 迁移工具手册
南大通用数据技术股份有限公司

- 19 -

图 4-17 迁移对象详情列表
页面提供根据类型、状态和结果进行查询。对于有错误信息的迁移对象，
可以双击查看错误信息详情，如图4-18 迁移对象详情展示，

图 4-18 迁移对象详情

“导出失败信息”您看可以对失败的任务信息进行导出。

“重建任务”您可以对失败的任务进行重建处理。

GBase Mingration Toolkit 迁移工具手册

- 20 -

南大通用数据技术股份有限公司

+--------------------+
1 row in set
示例3：expr 为“+000000123”。
gbase> SELECT TO_NUMBER('+000000123') FROM dual;
+-------------------------+
| TO_NUMBER('+000000123') |
+-------------------------+
|
123 |
+-------------------------+
1 row in set
示例4：expr 为“1234”。
gbase> SELECT TO_NUMBER('1234') FROM dual;
+-------------------+
| TO_NUMBER('1234') |
+-------------------+
|
1234 |
+-------------------+
1 row in set