SET DESCRIPTOR 语句

使用 SET DESCRIPTOR 来在系统描述符区域(SDA)中设置值。

随同 GBase 8s ESQL/C 使用此语句。

语法

元素 描述 限制 语法
descriptor 标识指定其值的 SDA 的字符串 先前必须分配了系统描述符区域(SDA) 用引号括起的字符串
descriptor_var 存储 descriptor 的主变量 descriptor 相同的限制 特定于语言
item_num 指定 SDA 中项描述符的次序位置的无符号整数 0 < item_num ≤ (当分配 SDA 时指定的项描述符的数目) 文字的数值
item_num_var 存储 item_num 的主变量 item_num 相同的限制 特定于语言
total_items 指定 SDA 描述的项的数量的无符号整数 item_num 相同的限制 文字的数值
total_items_var 存储 total_items 的主变量 total_items 的限制相同 特定于语言

用法

在您以 DESCRIBE ... USING SQL DESCRIPTOR 语句已描述了 SELECT、EXECUTE FUNCTION、EXECUTE PROCEDURE、ALLOCATE DESCRIPTOR 或 INSERT 语句之后,可使用 SET DESCRIPTOR 语句。

SET DESCRIPTOR 可在这些情况下给系统描述符区域指定值:
  • 设置系统描述符区域的 COUNT 字段来匹配您正在系统描述符区域中提供描述的项的数目。
  • 为您正在系统描述符区域中提供描述的每一值设置项描述符
  • 修改项描述符字段的内容

如果在给任何标识的系统描述符字段赋值期间发生错误,则将所有标识了的字段的内容设置为 0 或 NULL,这依赖于该变量的数据类型。

1 请参阅 项描述符