历史版本。 PostgreSQL 7.3 已结束支持。 请参阅 当前版本手册.
1.9. libpq 控制函数 #
默认情况下,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
等例程在需要时使用。