27.8. 控制函數

這些函數控制許多libpq雜項行為的細節。

PQsetErrorVerbosity

決定 PQerrorMessagePQresultErrorMessage 返回的信息的冗餘程度。

typedef enum {
    PQERRORS_TERSE,
    PQERRORS_DEFAULT,
    PQERRORS_VERBOSE
} PGVerbosity;

PGVerbosity PQsetErrorVerbosity(PGconn *conn, PGVerbosity verbosity);

PQsetErrorVerbosity 設置冗餘模式,返回連接的前一個設置。 在 terse 模式下,返回的消息只包括嚴重性,基本文本,以及位置信息; 這些東西通常只有一行。缺省模式生成的消息包括上面的信息加上任何細節,提示,或者環境字段(這些可能跨越幾行)。 VERBOSE 模式包括所有可以獲得的字段。修改冗餘模式不會影響我們能從已經存在的 PGresult 對象中獲取的信息, 只有隨後創建的 PGresult 對象才受到影響。

PQtrace

打開對前端/服務器通訊的跟蹤,把調試信息輸出到一個文件流裡。

void PQtrace(PGconn *conn
	     FILE *stream);

PQuntrace

關閉PQtrace打開的跟蹤。

void PQuntrace(PGconn *conn);