27.9. 控制函數

這些函數控制許多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);