INCLUDE 语句

INCLUDE 语句将声明插入到源程序中。

调用

此语句只能嵌入在应用程序中。它不是可执行语句。

权限

不需要执行任何操作。

语法

Read syntax diagram

Skip visual syntax diagram

描述

SQLCA: 指示要包含的 SQL 通信区 (SQLCA) 的描述。
SQLDA: 指示要包含的 SQL 描述符区域 (SQLDA) 的描述。
名称: 标识包含要包含在要预编译的源程序中的文本的外部文件。它可以是不带文件扩展名的 SQL 标识，也可以是用单引号 ('') 括起的文字。 SQL 标识采用正在预编译的源文件的文件名扩展名。如果文件扩展名未由用引号括起的文字提供，那么假定没有任何文件扩展名。

注意

预编译程序时， INCLUDE 语句将替换为源语句。因此，应该在程序中的某个点指定 INCLUDE 语句，以便编译器可以接受生成的源语句。
外部源文件必须以 name指定的主语言编写。如果它大于 18 个字节或包含 SQL 标识中不允许的字符，那么必须使用单引号将其括起。 INCLUDE name 语句可以嵌套，但不具有循环性 (例如，如果 A 和 B 是模块，并且 A 包含 INCLUDE name 语句，那么 A 调用 B ，然后 B 调用 A 无效)。
当使用 SQL92E 值指定 LANGLEVEL 预编译选项时，不应指定 INCLUDE SQLCA。可以在主变量声明部分中定义 SQLSTATE 和 SQLCODE 变量。

示例

在 C 程序中包含 SQLCA。

   EXEC SQL INCLUDE SQLCA;

   EXEC SQL DECLARE C1 CURSOR FOR
     SELECT DEPTNO, DEPTNAME, MGRNO FROM TDEPT
       WHERE ADMRDEPT = 'A00';

   EXEC SQL OPEN C1;

   while (SQLCODE==0) {
     EXEC SQL FETCH C1 INTO :dnum, :dname, :mnum;

   (Print results)

   }

   EXEC SQL CLOSE C1;