GBase8s数据库ALLOCATE ROW 语句

使用 ALLOCATE ROW 语句为 row 变量分配内存。该语句是 SQL ANSI/ISO 标准的扩展。在

ESQL/C 中使用此语句。

语法

元素 描述 限制 语法

variable 要分配的已归类或未

归类的 row 变量名称

必须为未分配的 GBase 8s

ESQL/C row 类型主变量

特定于

语言

用法

ALLOCATE ROW 语句为存储 row 类型数据的主变量分配内存。要创建 row 变量，ESQL/C 程序必须

执行以下操作：

声明 row 变量。row 变量可以是已归类或未归类的 row 变量。

使用 ALLOCATE ROW 语句为 row 变量分配内存。

以下示例显示如何使用 ALLOCATE ROW 语句为已归类的 row 变量 a_row 分配资源：

EXEC SQL BEGIN DECLARE SECTION;

row (a int, b int) a_row;

EXEC SQL END DECLARE SECTION;

. . .

EXEC SQL allocate row :a_row;

如果内存分配操作成功，则 ALLOCATE ROW 语句会将 SQLCODE （sqlca.sqlcode 的内容）置

零（0）；如果分配失败，会将其设置为一个负的错误码。

您必须使用 DEALLOCATE ROW 语句显示地释放内存。一旦您使用 DEALLOCATE ROW 语句释放了该

row 变量，您就可以重新使用该 row 变量。

提示： ALLOCATE ROW 语句仅为 GBase 8s ESQL/C row 变量分配内存。要为 GBase 8s ESQL/C

collection 变量分配内存，请使用 ALLOCATE COLLECTION 语句。

当您在多次函数调用中使用同一 row 变量而未对其解除分配时，会导致客户机计算机上的内存泄

露。因为没有办法确定指针在传递时是否是有效的，所以 GBase 8s ESQL/C 会假设它是无效的，

并将其分配到新的内存位置