PostgreSQL 7.2 文档 · 1.9. libpq 控制函数

文档 → PostgreSQL 7.2

受支持版本：当前版本 (18) / 17 / 16 / 15 / 14

测试与开发版本： 19 / devel

不受支持的版本： 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1

历史版本PostgreSQL 7.2 已于 2007 年 2 月结束社区维护，本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

1.9. libpq 控制函数
上一页	上一级	第 1 章 libpq - C 库	起始页	下一页

1.9. libpq 控制函数 #

PQsetNoticeProcessor 控制 libpq 产生的通知和警告消息的报告方式。

typedef void (*PQnoticeProcessor) (void *arg, const char *message);

PQnoticeProcessor
PQsetNoticeProcessor(PGconn *conn,
                     PQnoticeProcessor proc,
                     void *arg);

默认情况下，libpq 把来自后端的通知消息以及它自己产生的少量错误消息打印到 stderr。可以通过提供一个对这些消息另做处理的回调函数来改变这一行为。回调函数会收到错误消息的文本（包括末尾换行符），外加一个与传给 PQsetNoticeProcessor 的指针相同的 void 指针。（需要时可以用该指针访问应用特定的状态。）默认的通知处理器只是

static void
defaultNoticeProcessor(void * arg, const char * message)
{
    fprintf(stderr, "%s", message);
}

要使用特定的通知处理器，只需在创建新的 PGconn 对象之后立即调用 PQsetNoticeProcessor。

返回值是指向前一个通知处理器的指针。如果传入 NULL 回调函数指针，则不采取任何动作，但仍返回当前指针。

设置通知处理器之后，应当预期：只要 PGconn 对象或由它生成的 PGresult 对象仍存在，就可能调用该函数。创建 PGresult 时，PGconn 当前的通知处理器指针会被复制到 PGresult 中，供 PQgetvalue 等例程在需要时使用。

上一页	上一级	下一页
1.8. libpq 跟踪函数	起始页	1.10. 环境变量

提交更正

译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。