29.2. Charger pgtcl dans une application

Avant d'utiliser les commandes pgtcl, vous devez charger la biblioth�que libpgtcl dans votre application Tcl. Ceci se fait normalement avec la commande load command. Voici un exemple :

load libpgtcl[info sharedlibextension]

L'utilisation de info sharedlibextension est pr�f�r�e au codage en dur du .so ou du .sl dans le programme.

La commande load �chouera si le chargeur dynamique du syst�me ne sait pas o� trouver le fichier de la biblioth�que partag�e libpgtcl. Vous pourriez avoir besoin de travailler avec ldconfig ou d'initialiser la variable d'environnement LD_LIBRARY_PATH ou encore utiliser une fonctionnalit� �quivalente pour votre plateforme. R�f�rez-vous aux instructions d'installation de PostgreSQL pour plus d'informations.

libpgtcl d�pend de libpq, donc le chargeur dynamique doit �tre capable de trouver la biblioth�que partag�e libpq. En pratique, ceci est rarement un probl�me car les deux biblioth�ques sont normalement plac�es dans le m�me r�pertoire mais cela peut devenir un cas bloquant pour certaines configurations.

Si vous utilisez un ex�cutable personnalis� pour votre application, vous pourriez choisir de lier libpgtcl statiquement dans l'ex�cutable et, du coup, �viter la commande load et les probl�mes potentiels de chargement dynamique. Voir le code source de pgtclsh pour un exemple.