# 心电图
ecpg — 嵌入式 SQL C 预处理器
# 概要
心电图
[选项
...] 文件
...
# 描述
心电图
是 C 程序的嵌入式 SQL 预处理器。它通过将 SQL 调用替换为特殊的函数调用,将带有嵌入式 SQL 语句的 C 程序转换为普通的 C 代码。然后可以使用任何 C 编译器工具链处理输出文件。
心电图
将命令行中给出的每个输入文件转换为相应的 C 输出文件。如果输入文件名没有任何扩展名,.pgc
假设。文件的扩展名将替换为。C
构造输出文件名。但是输出文件名可以使用-o
选项。
如果输入文件名只是-
,心电图
从标准输入读取程序(并写入标准输出,除非它被覆盖-o
)。
此参考页面未描述嵌入式 SQL 语言。看第36章有关该主题的更多信息。
# 选项
心电图
接受以下命令行参数:
-c
从 SQL 代码自动生成某些 C 代码。目前,这适用于执行 SQL 类型
.
-C *
模式*
设置兼容模式。*模式
*可INFORMIX
,INFORMIX_SE
, 或者甲骨文
.
-D *
象征*
定义一个 C 预处理器符号。
-h
处理头文件。指定此选项时,输出文件扩展名变为。H
不是。C
, 默认输入文件扩展名是.pgh
不是.pgc
.此外,该-c
选项被强制打开。
-一世
解析系统也包含文件。
-一世 *
目录*
指定一个额外的包含路径,用于查找通过执行 SQL 包括
.默认值为.
(当前目录),/usr/local/包括
,在编译时定义的 PostgreSQL 包含目录(默认:/usr/local/pgsql/include
), 和/usr/包括
, 以该顺序。
-o *
文件名*
指定心电图
应该将其所有输出写入给定的*文件名
*.写-o-
将所有输出发送到标准输出。
-r *
选项*
选择运行时行为。*选项
*可以是以下之一:
no_indicator
不要使用指标,而是使用特殊值来表示空值。历史上已经有数据库使用这种方法。
准备
在使用它们之前准备所有语句。Libecpg 将保留准备好的语句的缓存,并在再次执行时重用语句。如果缓存已满,libecpg 将释放最少使用的语句。
问号
出于兼容性原因,允许问号作为占位符。这曾经是很久以前的默认设置。
-t
打开事务的自动提交。在这种模式下,每个 SQL 命令都会自动提交,除非它位于显式事务块内。在默认模式下,仅在以下情况下提交命令执行 SQL 提交
发出。
-v
打印附加信息,包括版本和“包含”路径。
- 版本
打印 ecpg 版本并退出。
-?
- 帮助
显示有关 ecpg 命令行参数的帮助,然后退出。
# 笔记
在编译预处理的 C 代码文件时,编译器需要能够在 PostgreSQL 的包含目录中找到 ECPG 头文件。因此,您可能必须使用-一世
调用编译器时的选项(例如,-I/usr/local/pgsql/包括
)。
使用带有嵌入式 SQL 的 C 代码的程序必须与libecpg
库,例如使用链接器选项-L/usr/local/pgsql/lib -lecpg
.
可以使用以下命令找到适合安装的这些目录中的任何一个的值皮克_配置.
# 例子
如果您有一个名为的嵌入式 SQL C 源文件prog1.pgc
,您可以使用以下命令序列创建可执行程序:
ecpg prog1.pgc
cc -I/usr/local/pgsql/include -c prog1.c
cc -o prog1 prog1.o -L/usr/local/pgsql/lib -lecpg