↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

已结束支持的版本: 7.0 / 6.4
历史版本。 PostgreSQL 7.0 已结束支持。 请参阅 当前版本手册.

53.8. libpq 控制函数

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

    typedef void (*PQnoticeProcessor) (void *arg, const char *message);
    
    PQnoticeProcessor
    PQsetNoticeProcessor(PGconn *conn,
                         PQnoticeProcessor proc,
                         void *arg);

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

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

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

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

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

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.