NAME

Locale::gettext_pp - Pure Perl Implementation of Uniforum Message Translation

SYNOPSIS

 use 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 GNU 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 GNU 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 ("EXPORT TAGS").

gettext MSGID: See FUNCTIONS in Locale::Messages.
dgettext TEXTDOMAIN, MSGID: See FUNCTIONS in Locale::Messages.
dcgettext TEXTDOMAIN, MSGID, CATEGORY: See FUNCTIONS in Locale::Messages.
ngettext MSGID, MSGID_PLURAL, COUNT: See FUNCTIONS in Locale::Messages.
dngettext TEXTDOMAIN, MSGID, MSGID_PLURAL, COUNT: See FUNCTIONS in Locale::Messages.
dcngettext TEXTDOMAIN, MSGID, MSGID_PLURAL, COUNT, CATEGORY: See FUNCTIONS in Locale::Messages.
pgettext MSGCTXT, MSGID: See FUNCTIONS in Locale::Messages.
dpgettext TEXTDOMAIN, MSGCTXT, MSGID: See FUNCTIONS in Locale::Messages.
dcpgettext TEXTDOMAIN, MSGCTXT, MSGID, CATEGORY: See FUNCTIONS in Locale::Messages.
npgettext MSGCTXT, MSGID, MSGID_PLURAL, COUNT: See FUNCTIONS in Locale::Messages.
dnpgettext TEXTDOMAIN, MSGCTXT, MSGID, MSGID_PLURAL, COUNT: See FUNCTIONS in Locale::Messages.
dcnpgettext TEXTDOMAIN, MSGCTXT, MSGID, MSGID_PLURAL, COUNT, CATEGORY: See FUNCTIONS in Locale::Messages.
textdomain TEXTDOMAIN: See FUNCTIONS in Locale::Messages.
bindtextdomain TEXTDOMAIN, DIRECTORY: See FUNCTIONS in Locale::Messages.
bind_textdomain_codeset TEXTDOMAIN, ENCODING
nl_putenv ENVSPEC: See FUNCTIONS in Locale::Messages.

CONSTANTS

You can (maybe) get the same constants from POSIX(3); see there for a detailed description

LC_CTYPE
LC_NUMERIC
LC_TIME
LC_COLLATE
LC_MONETARY
LC_MESSAGES
LC_ALL: See CONSTANTS 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:

LC_CTYPE
LC_NUMERIC
LC_TIME
LC_COLLATE
LC_MONETARY
LC_MESSAGES
LC_ALL

AUTHOR

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