27.8. Fonctions de contrôle

Ces fonctions contrôlent divers détails du comportement de libpq.

PQsetErrorVerbosity

Détermine la verbosité des messages renvoyés par PQerrorMessage et PQresultErrorMessage.

typedef enum {
    PQERRORS_TERSE,
    PQERRORS_DEFAULT,
    PQERRORS_VERBOSE
} PGVerbosity;

PGVerbosity PQsetErrorVerbosity(PGconn *conn, PGVerbosity verbosity);

PQsetErrorVerbosity initialise le mode de verbosité et retourne le paramétrage précédent de cette connexion. Dans le mode terse, les messages renvoyés incluent seulement la sévérité, le texte principal et la position ; ceci tient normalement sur une seule ligne. Le mode par défaut produit des messages qui inclut ces champs ainsi que les champs détail, astuce ou contexte (ils peuvent être sur plusieurs lignes). Le mode VERBOSE inclut tous les champs disponibles. Modifier la verbosité n'affecte pas les messages disponibles à partir d'objets PGresult déjà existants, seulement ceux créés après.

PQtrace

Active les traces de communication entre client et serveur vers un flux fichier de débogage.

void PQtrace(PGconn *conn, FILE *stream);

PQuntrace

Désactive les traces activées avec PQtrace.

void PQuntrace(PGconn *conn);