| PostgreSQL 9.6.0 手册 | |||
|---|---|---|---|
| 上一页 | 上一级 | 章 34. ECPG - C 中的嵌入式 SQL | 下一页 |
34.9. 预处理器指令
一些预处理器指令可以用来改变ecpg预处理器解析和处理一个文件的方式。
34.9.1. 包括文件
要包括一个外部文件到你的嵌入式 SQL 程序中，可以用：
EXEC SQL INCLUDE filename; EXEC SQL INCLUDE <filename>; EXEC SQL INCLUDE "filename";
嵌入式 SQL 预处理器将查找一个名为filename.h的文件，处理它并且把它包括在结果 C 输出中。这样，被包括文件中的嵌入式 SQL 语句会被正确地处理。
ecpg预处理器将以下列顺序在几个目录中搜索一个文件：
-
当前目录
-
/usr/local/include
-
PostgreSQL 的包括目录，在编译时定义（例如/usr/local/pgsql/include）
-
/usr/include
但是当使用EXEC SQL INCLUDE "filename"时，只有当前目录会被搜索。
在每一个目录中，预处理器将首先按给定的文件名搜索，如果没有找到将会追加.h到文件名并且重试（除非指定的文件名已经具有该后缀）。
注意EXEC SQL INCLUDE不同于：
#include <filename.h>
因为这个文件不服从 SQL 命令预处理。自然地，你可以继续使用 C 的#include指令来包括其他头文件。
注意: 包括文件名是大小写敏感的，即使EXEC SQL INCLUDE命令的剩余部分遵守通常的 SQL 大小写敏感规则。
34.9.2. define 和 undef 指令
与 C 中我们熟知的指令#define相似，嵌入式 SQL 具有类似的概念：
EXEC SQL DEFINE name; EXEC SQL DEFINE name value;
因此你可以定义一个名称：
EXEC SQL DEFINE HAVE_FEATURE;
并且你也可以定义常量：
EXEC SQL DEFINE MYNUMBER 12; EXEC SQL DEFINE MYSTRING 'abc';
使用undef来移除一个之前的定义：
EXEC SQL UNDEF MYNUMBER;
当然在你的嵌入式 SQL 程序中你可以继续使用 C 版本的#define和#undef。区别在于你定义的值会在哪里被计算。如果你使用EXEC SQL DEFINE，那么ecpg预处理器会计算这些定义并且替换值。例如，如果你写：
EXEC SQL DEFINE MYNUMBER 12; ... EXEC SQL UPDATE Tbl SET col = MYNUMBER;
那么ecpg将已经做过替换并且你的 C 编译器将永远不会看见名为MYNUMBER的任何名称或标识符。注意你不能把#define用于一个将要在一个嵌入式 SQL 查询中使用的常量，因为在这种情况下嵌入式 SQL 预编译器不能看到这个声明。
34.9.3. ifdef、ifndef、else、elif 以及 endif 指令
你可以使用下列指定来有条件地编译代码小节：
- EXEC SQL ifdef name;
-
检查一个name，如果已经用EXEC SQL define name创建了name就处理接下来的行。
- EXEC SQL ifndef name;
-
检查一个name，如果没有用EXEC SQL define name创建name就处理接下来的行。
- EXEC SQL else;
-
为一个由EXEC SQL ifdef name或者EXEC SQL ifndef name引入的小节开始处理一个备选小节。
- EXEC SQL elif name;
-
检查name，如果已经用EXEC SQL define name创建了name就开始处理一个备选小节。
- EXEC SQL endif;
-
结束一个备选小节。
例子：
EXEC SQL ifndef TZVAR; EXEC SQL SET TIMEZONE TO 'GMT'; EXEC SQL elif TZNAME; EXEC SQL SET TIMEZONE TO TZNAME; EXEC SQL else; EXEC SQL SET TIMEZONE TO TZVAR; EXEC SQL endif;