Locale::gettext_pp: Pure perl implementation of uniforum message translation

SYNOPSIS

 use Locale::gettext_pp (:locale_h :libintl_h);

 gettext $msgid;
 dgettext $domainname, $msgid;
 dcgettext $domainname, $msgid, LC_MESSAGES;
 ngettext $msgid, $msgid_plural, $count;
 dngettext $domainname, $msgid, $msgid_plural, $count;
 dcngettext $domainname, $msgid, $msgid_plural, $count, LC_MESSAGES;
 pgettext $msgctxt, $msgid;
 dpgettext $domainname, $msgctxt, $msgid;
 dcpgettext $domainname, $msgctxt, $msgid, LC_MESSAGES;
 npgettext $msgctxt, $msgid, $msgid_plural, $count;
 dnpgettext $domainname, $msgctxt, $msgid, $msgid_plural, $count;
 dcnpgettext $domainname, $msgctxt, $msgid, $msgid_plural, $count, LC_MESSAGES;
 textdomain $domainname;
 bindtextdomain $domainname, $directory;
 bind_textdomain_codeset $domainname, $encoding;
 my $category = LC_CTYPE;
 my $category = LC_NUMERIC;
 my $category = LC_TIME;
 my $category = LC_COLLATE;
 my $category = LC_MONETARY;
 my $category = LC_MESSAGES;
 my $category = LC_ALL;

DESCRIPTION

The module Locale::gettext_pp is the low-level interface to message translation according to the Uniforum approach that is for example used in \s-1GNU\s0 gettext and Sun's Solaris.

Normally you should not use this module directly, but the high level interface Locale::TextDomain\|(3) that provides a much simpler interface. This description is therefore deliberately kept brief. Please refer to the \s-1GNU\s0 gettext documentation available at <http://www.gnu.org/manual/gettext/> for in-depth and background information on the topic.

FUNCTIONS

The module exports by default nothing. Every function has to be imported explicitely or via an export tag (\*(L"\s-1EXPORT\s0 \s-1TAGS\s0\*(R").

gettext \s-1MSGID\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
dgettext \s-1TEXTDOMAIN\s0, \s-1MSGID\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
dcgettext \s-1TEXTDOMAIN\s0, \s-1MSGID\s0, \s-1CATEGORY\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
ngettext \s-1MSGID\s0, \s-1MSGID_PLURAL\s0, \s-1COUNT\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
dngettext \s-1TEXTDOMAIN\s0, \s-1MSGID\s0, \s-1MSGID_PLURAL\s0, \s-1COUNT\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
dcngettext \s-1TEXTDOMAIN\s0, \s-1MSGID\s0, \s-1MSGID_PLURAL\s0, \s-1COUNT\s0, \s-1CATEGORY\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
pgettext \s-1MSGCTXT\s0, \s-1MSGID\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
dpgettext \s-1TEXTDOMAIN\s0, \s-1MSGCTXT\s0, \s-1MSGID\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
dcpgettext \s-1TEXTDOMAIN\s0, \s-1MSGCTXT\s0, \s-1MSGID\s0, \s-1CATEGORY\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
npgettext \s-1MSGCTXT\s0, \s-1MSGID\s0, \s-1MSGID_PLURAL\s0, \s-1COUNT\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
dnpgettext \s-1TEXTDOMAIN\s0, \s-1MSGCTXT\s0, \s-1MSGID\s0, \s-1MSGID_PLURAL\s0, \s-1COUNT\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
dcnpgettext \s-1TEXTDOMAIN\s0, \s-1MSGCTXT\s0, \s-1MSGID\s0, \s-1MSGID_PLURAL\s0, \s-1COUNT\s0, \s-1CATEGORY\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
textdomain \s-1TEXTDOMAIN\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
bindtextdomain \s-1TEXTDOMAIN\s0, \s-1DIRECTORY\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.
bind_textdomain_codeset \s-1TEXTDOMAIN\s0, \s-1ENCODING\s0
nl_putenv \s-1ENVSPEC\s0: See \*(L"\s-1FUNCTIONS\s0\*(R" in Locale::Messages.

CONSTANTS

You can (maybe) get the same constants from \s-1POSIX\s0\|(3); see there for a detailed description

\s-1LC_CTYPE\s0
\s-1LC_NUMERIC\s0
\s-1LC_TIME\s0
\s-1LC_COLLATE\s0
\s-1LC_MONETARY\s0
\s-1LC_MESSAGES\s0
\s-1LC_ALL\s0: See \*(L"\s-1CONSTANTS\s0\*(R" in Locale::Messages for more information.

EXPORT TAGS

This module does not export anything unless explicitely requested. You can import groups of functions via two tags:

use Locale::gettext_pp (':locale_h')

Imports the functions that are normally defined in the C include file locale.h:

gettext()
dgettext()
dcgettext()
ngettext()
dngettext()
dcngettext()
pgettext(): Introduced with libintl-perl 1.17.
dpgettext(): Introduced with libintl-perl 1.17.
dcpgettext(): Introduced with libintl-perl 1.17.
npgettext(): Introduced with libintl-perl 1.17.
dnpgettext(): Introduced with libintl-perl 1.17.
dcnpgettext(): Introduced with libintl-perl 1.17.
textdomain()
bindtextdomain()
bind_textdomain_codeset()

use Locale::gettext_pp (':libintl_h')

Imports the locale category constants:

\s-1LC_CTYPE\s0
\s-1LC_NUMERIC\s0
\s-1LC_TIME\s0
\s-1LC_COLLATE\s0
\s-1LC_MONETARY\s0
\s-1LC_MESSAGES\s0
\s-1LC_ALL\s0

AUTHOR

This software is contributed to the Perl community by Imperia (<http://www.imperia.net/>).

RELATED TO Locale::gettext_pp…

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 1086:: =cut found outside a pod block. Skipping to next block.

Locale::gettext_pp (3pm)