perl-gettext

Il modulo gettext consente l'accesso da perl alla famiglia di funzioni gettext() per recuperare stringhe di messaggi da database costruiti per internazionalizzare il software. * $d = Locale::gettext->domain(DOMAIN) * $d = Locale::gettext->domain_raw(DOMAIN) Crea un nuovo oggetto per recuperare stringhe nel dominio *DOMAIN* e lo restituisce. 'domain' richiede che le stringhe siano restituite come stringhe Perl (possibilmente con wide characters) se possibile, mentre 'domain_raw' richiede che le stringhe di ottetti provengano direttamente da funzioni come 'dgettext()'. * $d->get(MSGID) Chiama 'dgettext()' per restituire la stringa tradotta per il *MSGID* dato. * $d->cget(MSGID, CATEGORY) Chiama 'dcgettext()' per restituire la stringa tradotta per il *MSGID* dato nella *CATEGORY* data. * $d->nget(MSGID, MSGID_PLURAL, N) Chiama 'dngettext()' per restituire la stringa tradotta per il *MSGID* dato o *MSGID_PLURAL* a seconda di *N*. * $d->ncget(MSGID, MSGID_PLURAL, N, CATEGORY) Chiama 'dngettext()' per restituire la stringa tradotta per il *MSGID* dato o *MSGID_PLURAL* a seconda di *N* nella *CATEGORY* data. * $d->dir([NEWDIR]) Se viene dato *NEWDIR*, chiama 'bindtextdomain' per impostare il nome della directory in cui si trovano i messaggi per il dominio rappresentato da '$d'. Restituisce il nome della directory corrente (eventualmente modificato). * $d->codeset([NEWCODE]) Per le istanze create con 'Locale::gettext->domain_raw', manipola il set di caratteri delle stringhe restituite. Se viene dato *NEWCODE*, chiama 'bind_textdomain_codeset' per impostare la codifica dei caratteri in cui vengono restituiti i messaggi per il dominio rappresentato da '$d'. Restituisce il nome della codifica corrente (eventualmente modificato). gettext(), dgettext() e dcgettext() tentano di recuperare una stringa che corrisponda al loro parametro 'msgid' nel contesto della locale corrente. dcgettext() prende la categoria del messaggio e il dominio di testo come parametri mentre dgettext() usa per impostazione predefinita la categoria LC_MESSAGES e gettext() usa per impostazione predefinita LC_MESSAGES e il dominio di testo corrente. Se la stringa non viene trovata nel database, viene restituito 'msgid'. ngettext(), dngettext() e dcngettext() funzionano in modo simile ma implementano la differenziazione dei messaggi tra singolare e plurale. Vedere la documentazione delle corrispondenti funzioni C per i dettagli. textdomain() imposta il dominio di testo corrente e restituisce il dominio precedentemente attivo. _bindtextdomain(domain, dirname)_ istruisce le funzioni di recupero a cercare i database appartenenti al dominio 'domain' nella directory 'dirname' _bind_textdomain_codeset(domain, codeset)_ istruisce le funzioni di recupero a tradurre i messaggi restituiti nella codifica dei caratteri data da *codeset* se la codifica del catalogo dei messaggi è nota.