perl-gettext

Le module gettext permet l'accès depuis perl à la famille de fonctions gettext() pour récupérer des chaînes de messages depuis des bases de données construites pour internationaliser les logiciels. * $d = Locale::gettext->domain(DOMAIN) * $d = Locale::gettext->domain_raw(DOMAIN) Crée un nouvel objet pour récupérer des chaînes dans le domaine *DOMAIN* et le renvoie. 'domain' demande que les chaînes soient renvoyées comme chaînes Perl (éventuellement avec des caractères larges) si possible, tandis que 'domain_raw' demande que les chaînes d'octets viennent directement de fonctions comme 'dgettext()'. * $d->get(MSGID) Appelle 'dgettext()' pour renvoyer la chaîne traduite pour le *MSGID* donné. * $d->cget(MSGID, CATEGORY) Appelle 'dcgettext()' pour renvoyer la chaîne traduite pour le *MSGID* donné dans la *CATEGORY* donnée. * $d->nget(MSGID, MSGID_PLURAL, N) Appelle 'dngettext()' pour renvoyer la chaîne traduite pour le *MSGID* donné ou *MSGID_PLURAL* selon *N*. * $d->ncget(MSGID, MSGID_PLURAL, N, CATEGORY) Appelle 'dngettext()' pour renvoyer la chaîne traduite pour le *MSGID* donné ou *MSGID_PLURAL* selon *N* dans la *CATEGORY* donnée. * $d->dir([NEWDIR]) Si *NEWDIR* est donné, appelle 'bindtextdomain' pour définir le nom du répertoire où se trouvent les messages du domaine représenté par '$d'. Renvoie le nom du répertoire actuel (éventuellement modifié). * $d->codeset([NEWCODE]) Pour les instances créées avec 'Locale::gettext->domain_raw', manipule le jeu de caractères des chaînes renvoyées. Si *NEWCODE* est donné, appelle 'bind_textdomain_codeset' pour définir l'encodage de caractères dans lequel les messages du domaine représenté par '$d' sont renvoyés. Renvoie le nom de l'encodage actuel (éventuellement modifié). gettext(), dgettext() et dcgettext() tentent de récupérer une chaîne correspondant à leur paramètre 'msgid' dans le contexte de la locale actuelle. dcgettext() prend la catégorie du message et le domaine de texte comme paramètres tandis que dgettext() utilise par défaut la catégorie LC_MESSAGES et gettext() utilise par défaut LC_MESSAGES et le domaine de texte actuel. Si la chaîne n'est pas trouvée dans la base de données, alors 'msgid' est renvoyé. ngettext(), dngettext() et dcngettext() fonctionnent de manière similaire mais implémentent la différenciation des messages entre singulier et pluriel. Consultez la documentation des fonctions C correspondantes pour plus de détails. textdomain() définit le domaine de texte actuel et renvoie le domaine précédemment actif. _bindtextdomain(domain, dirname)_ indique aux fonctions de récupération de chercher les bases de données appartenant au domaine 'domain' dans le répertoire 'dirname' _bind_textdomain_codeset(domain, codeset)_ indique aux fonctions de récupération de traduire les messages renvoyés vers l'encodage de caractères donné par *codeset* si l'encodage du catalogue de messages est connu.