这一节解释ECPG在内部如何工作。这些信息有时有助于用户理解如何使用ECPG。
ecpg写入输出的前四行是固定的:其中两行是注释,另外两行是与库接口所必需的包含行。随后预处理器会通读整个文件并写出输出,通常它只是把所有内容原样回显到输出中。
当它看到EXEC SQL语句时,就会介入并对其进行改写。命令以EXEC SQL开始,以;结束。其间的所有内容都会被视为一条SQL语句,并进行变量替换解析。
当某个符号以冒号(:)开头时,就会发生变量替换。系统会在此前于EXEC SQL DECLARE声明节中声明的变量里查找同名变量。
该库中最重要的函数是ECPGdo,它负责执行大部分命令。它采用可变数量的参数。可以很容易地增加到最多 50 个左右的参数,并且我们希望在任何平台上这都不会成为问题。
参数是:
对于每一个作为SQL命令一部分的变量,该函数得到十个参数:
作为一个特殊符号的类型。
一个值的指针或者一个指针的指针。
如果变量是一个char或者varchar,这是它的尺寸。
数组中元素的数量(用于数组获取)。
数组中下一个元素的偏移量(用于数组获取)。
作为一个特殊符号的指示符变量的类型。
一个指示符变量的指针。
0
指示符数组中的元素数量(用于数组获取)。
到指示符数组中下一个元素的偏移量(用于数组获取)。
注意并非所有 SQL 命令都被以这种方式对待。例如,一个打开游标语句:
EXEC SQL OPEN cursor;
它不会被复制到输出中。相反,游标的DECLARE命令会被放在OPEN命令的位置上,因为真正打开游标的正是它。
这里有一个完整的例子,它描述了一个文件foo.pgc的预处理器输出(对预处理器的每一个特定版本细节可能不同):
EXEC SQL BEGIN DECLARE SECTION; int index; int result; EXEC SQL END DECLARE SECTION; ... EXEC SQL SELECT res INTO :result FROM mytable WHERE index = :index;
会被转换成:
/* 由 ecpg (2.6.0) 处理 */
/* 这两个头文件由预处理器增加 */
#include <ecpgtype.h>;
#include <ecpglib.h>;
/* 声明节开始 */
#line 1 "foo.pgc"
int index;
int result;
/* 声明节结束 */
...
ECPGdo(__LINE__, NULL, "SELECT res FROM mytable WHERE index = ? ",
ECPGt_int,&(index),1L,1L,sizeof(int),
ECPGt_NO_INDICATOR, NULL , 0L, 0L, 0L, ECPGt_EOIT,
ECPGt_int,&(result),1L,1L,sizeof(int),
ECPGt_NO_INDICATOR, NULL , 0L, 0L, 0L, ECPGt_EORT);
#line 147 "foo.pgc"
(这里的缩进是为了可读性而添加的,并非是预处理器做的处理)。
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。