1.8. libpq 控制函数

• PQsetNoticeProcessor 控制 libpq 生成的通知和警告信息的汇报．

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

缺省时，libpq 在后端往 stderr 上打印“通知”信息和一些它自身生成的错误信息． 这个特性可以通过提供一个对信息进行某种加工的回叫函数来更改． 我们向这个回叫函数传递错误信息的文本（包括文本结尾的换行符）， 和一个空（void）指针，该指针与传递给 PQsetNoticeProcessor 的完全一样． （如果需要，这个指针可以用于访问应用相关的状态．）缺省的通知处理器只是简单的

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

要使用特殊的通知处理器，在创建完新的 PGconn 对象后马上调用 PQsetNoticeProcessor。

返回值是指向以前的通知处理器的指针。如果你提供了一个 NULL 做为回调指针， 那么不会发生任何动作，只是返回当前的指针。

一旦你设置了一个通知处理器， 你就应该预料到该函数可能在 PGconn 对象或 PGresult 对象从开始存在时起就可能被调用． 当创建一个 PGresult 时，PGconn 的当前的通知指针被拷贝到 PGresult 里提供给可能需要的过程， 如 PQgetvalue 使用．