36.11. 库功能

libecpg库主要包含“隐藏”功能,这些功能用于实现嵌入式 SQL 命令表示的功能。但是有些功能可以直接调用,很有用。请注意,这使您的代码不可移植。

  • 如果第一个参数不为零,则ECPGdebug(int on, FILE *stream)打开调试日志记录。调试日志记录是在* stream *上完成的。该日志包含插入了所有 Importing 变量的所有 SQL 语句以及 PostgreSQL 服务器的结果。在 SQL 语句中搜索错误时,这可能非常有用。

Note

在 Windows 上,如果 ecpg 库和应用程序使用不同的标志进行编译,则此函数调用将使应用程序崩溃,因为FILE指针的内部表示形式有所不同。具体来说,该库以及使用该库的所有应用程序的多线程/单线程,发行/调试和静态/动态标志应相同。

  • ECPGget_PGconn(const char *connection_name)返回由给定名称标识的库数据库连接句柄。如果* connection_name *设置为NULL,则返回当前连接句柄。如果无法识别连接句柄,则该函数返回NULL。如有必要,可以使用返回的连接句柄从 libpq 调用任何其他函数。

Note

直接使用 libpq 例程操作由 ecpg 制成的数据库连接句柄是一个坏主意。

  • ECPGtransactionStatus(const char *connection_name)返回由* connection_name *标识的给定连接的当前事务状态。有关返回的状态码的详细信息,请参见Section 34.2和 libpq 的PQtransactionStatus()

  • 如果您已连接到数据库,ECPGstatus(int lineno, const char* connection_name)返回 true,否则返回 false。如果使用单个连接,则connection_name *可以是NULL