NAME<\/a> Locale::gettext \u2212 message handling functions<\/p>\n use Locale::gettext; The gettext module permits access from perl to the gettext()<\/b> family of functions for retrieving message strings from databases constructed to internationalize software. Creates a new object for retrieving strings in the domain DOMAIN<\/small><\/b> and returns it. “domain” requests that strings be returned as Perl strings (possibly with wide characters) if possible while “domain_raw” requests that octet strings directly from functions like “dgettext()”.<\/p>\n $d\u2212>get( MSGID<\/small> )<\/p>\n Calls “dgettext()” to return the translated string for the given MSGID<\/small><\/b> .<\/p>\n $d\u2212>cget( MSGID, CATEGORY<\/small> )<\/p>\n Calls “dcgettext()” to return the translated string for the given MSGID<\/small><\/b> in the given CATEGORY<\/small><\/b> .<\/p>\n $d\u2212>nget( MSGID, MSGID_PLURAL, N<\/small> )<\/p>\n Calls “dngettext()” to return the translated string for the given MSGID<\/small><\/b> or MSGID_PLURAL<\/small><\/b> depending on N<\/b>.<\/p>\n $d\u2212>ncget( MSGID, MSGID_PLURAL, N, CATEGORY<\/small> )<\/p>\n Calls “dngettext()” to return the translated string for the given MSGID<\/small><\/b> or MSGID_PLURAL<\/small><\/b> depending on N<\/b> in the given CATEGORY<\/small><\/b> .<\/p>\n $d\u2212>dir([ NEWDIR<\/small> ])<\/p>\n If NEWDIR<\/small><\/b> is given, calls “bindtextdomain” to set the name of the directory where messages for the domain represented by $d are found. Returns the (possibly changed) current directory name.<\/p>\n $d\u2212>codeset([ NEWCODE<\/small> ])<\/p>\n For instances created with “Locale::gettext\u2212>domain_raw”, manuiplates the character set of the returned strings. If NEWCODE<\/small><\/b> is given, calls “bind_textdomain_codeset” to set the character encoding in which messages for the domain represented by $d are returned. Returns the (possibly changed) current encoding name.<\/p>\n gettext()<\/b>, dgettext()<\/b>, and dcgettext()<\/b> attempt to retrieve a string matching their “msgid” parameter within the context of the current locale. dcgettext()<\/b> takes the message\u2019s category and the text domain as parameters while dgettext()<\/b> defaults to the LC_MESSAGES<\/small> category and gettext()<\/b> defaults to LC_MESSAGES<\/small> and uses the current text domain. If the string is not found in the database, then “msgid” is returned.<\/p>\n ngettext()<\/b>, dngettext()<\/b>, and dcngettext()<\/b> function similarily but implement differentiation of messages between singular and plural. See the documentation for the corresponding C functions for details.<\/p>\n textdomain()<\/b> sets the current text domain and returns the previously active domain.<\/p>\n bindtextdomain(domain, dirname)<\/i> instructs the retrieval functions to look for the databases belonging to domain “domain” in the directory “dirname”<\/p>\n bind_textdomain_codeset(domain, codeset)<\/i> instructs the retrieval functions to translate the returned messages to the character encoding given by codeset<\/b> if the encoding of the message catalog is known.<\/p>\n Not all platforms provide all of the functions. Functions that are not available in the underlying C library will not be available in Perl either.<\/p>\n Perl programs should use the object interface. In addition to being able to return native Perl wide character strings, “bind_textdomain_codeset” will be emulated if the C library does not provide it.<\/p>\n 1.07.<\/p>\n
SYNOPSIS<\/a>
DESCRIPTION<\/a>
NOTES<\/a>
VERSION<\/a>
SEE ALSO<\/a>
AUTHOR<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
SYNOPSIS <\/a> <\/h2>\n
use POSIX; # Needed for setlocale()
setlocale(LC_MESSAGES, “”);
# OO interface
my $d = Locale::gettext\u2212>domain(“my_program”);
print $d\u2212>get(“Welcome to my program”), “n”;
# (printed in the local language)
# Direct access to C functions
textdomain(“my_program”);
print gettext(“Welcome to my program”), “n”;
# (printed in the local language)<\/p>\nDESCRIPTION <\/a> <\/h2>\n
$d = Locale::gettext\u2212>domain( DOMAIN<\/small> )
$d = Locale::gettext\u2212>domain_raw( DOMAIN<\/small> )<\/p>\nNOTES <\/a> <\/h2>\n
VERSION <\/a> <\/h2>\n
SEE ALSO <\/a> <\/h2>\n