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

Copyright (C) 2002-2013, Guido Flohr <[email protected]>, all rights reserved. See the source code for details.

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

RELATED TO Locale::gettext_pp…

Locale::TextDomain\|(3pm), Locale::Messages\|(3pm), Encode\|(3pm), perllocale\|(3pm), \s-1POSIX\s0\|(3pm), perl\|(1), gettext\|(1), gettext\|(3)

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.