33.11. Fonctions de la Librairie

ECPGdebug(int on, FILE *stream) active les traces de déboggage si appelé avec une valeur différente de 0 en premier argument. La trace contient tous les ordres SQL avec toutes les variables d'entrées insérées, et les résultats du serveur PostgreSQL™. Cela peut �tre tr�s utile quand vous �tes � la recherche d'erreurs dans vos ordres SQL.

Note

Sous Windows, si les librairies ecpg et les applications sont compilées avec des options différentes, cet appel de fonction fera planter l'application parce que la représentation interne des pointeurs FILE diff�re. En particulier, les options multithreaded/single-threaded, release/debug, et static/dynamic doivent �tre les m�mes pour la librairie et toutes les applications qui l'utilisent.

ECPGget_PGconn(const char *nom_connexion) retourne le descriteur de connexion � la base de données de la librairie identifié par le nom fourni. Si nom_connexion est positionné � NULL, le descripteur de connexion courant est retourné. Si aucun descripteur de connexion ne peut �tre identifié, la fonction retourne NULL. Le descripteur de connexion retourné peut �tre utilisé pour appeler toute autre fonction de la libpq, si nécessaire.

Note

C'est une mauvaise idée de manipuler les descripteurs de connexion � la base de donnée faits par ecpg directement avec des routines de libpq.

ECPGtransactionStatus(const char *nom_connexion) retourne l'état de la transaction courante de la connexion identifiée par nom_connexion. Voyez Section 31.2, � Fonctions de statut de connexion � et la fonction de la libpq PQtransactionStatus() pour les détails � propos des codes d'état retournés.

ECPGstatus(int lineno, const char* nom_connexion) retoure vrai si vous �tes connecté � une base et faux sinon. nom_connexion peut valoir NULL si une seule connexion est utilisée.