• NAME
• SYNOPSIS
• DESCRIPTION
• FUNCTIONS
• CONSTANTS
• EXPORT TAGS
• AUTHOR
• SEE ALSO

NAME

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

SYNOPSIS

 use Locale::gettext_pp qw(: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 the Locale::Messages manpage.

dgettext TEXTDOMAIN, MSGID

See FUNCTIONS in the Locale::Messages manpage.

dcgettext TEXTDOMAIN, MSGID, CATEGORY

See FUNCTIONS in the Locale::Messages manpage.

ngettext MSGID, MSGID_PLURAL, COUNT

See FUNCTIONS in the Locale::Messages manpage.

dngettext TEXTDOMAIN, MSGID, MSGID_PLURAL, COUNT

See FUNCTIONS in the Locale::Messages manpage.

dcngettext TEXTDOMAIN, MSGID, MSGID_PLURAL, COUNT, CATEGORY

See FUNCTIONS in the Locale::Messages manpage.

pgettext MSGCTXT, MSGID

See FUNCTIONS in the Locale::Messages manpage.

dpgettext TEXTDOMAIN, MSGCTXT, MSGID

See FUNCTIONS in the Locale::Messages manpage.

dcpgettext TEXTDOMAIN, MSGCTXT, MSGID, CATEGORY

See FUNCTIONS in the Locale::Messages manpage.

npgettext MSGCTXT, MSGID, MSGID_PLURAL, COUNT

See FUNCTIONS in the Locale::Messages manpage.

dnpgettext TEXTDOMAIN, MSGCTXT, MSGID, MSGID_PLURAL, COUNT

See FUNCTIONS in the Locale::Messages manpage.

dcnpgettext TEXTDOMAIN, MSGCTXT, MSGID, MSGID_PLURAL, COUNT, CATEGORY

See FUNCTIONS in the Locale::Messages manpage.

textdomain TEXTDOMAIN

See FUNCTIONS in the Locale::Messages manpage.

bindtextdomain TEXTDOMAIN, DIRECTORY

See FUNCTIONS in the Locale::Messages manpage.

bind_textdomain_codeset TEXTDOMAIN, ENCODING

nl_putenv ENVSPEC

See FUNCTIONS in the Locale::Messages manpage.

setlocale

See FUNCTIONS in the Locale::Messages manpage.

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 the Locale::Messages manpage 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 qw(':locale_h')

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

gettext()gettext()

dgettext()dgettext()

dcgettext()dcgettext()

ngettext()

dngettext()

dcngettext()

pgettext()pgettext()

Introduced with libintl-perl 1.17.

dpgettext()dpgettext()

Introduced with libintl-perl 1.17.

dcpgettext()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()textdomain()

bindtextdomain()bindtextdomain()

bind_textdomain_codeset()

use Locale::gettext_pp (':libintl_h')

Imports the locale category constants:

LC_CTYPELC_CTYPE

LC_NUMERICLC_NUMERIC

LC_TIMELC_TIME

LC_COLLATELC_COLLATE

LC_MONETARYLC_MONETARY

LC_MESSAGESLC_MESSAGES

LC_ALLLC_ALL

AUTHOR

Copyright (C) 2002-2017 Guido Flohr (mailto:guido.flohr@cantanea.com), all rights reserved. See the source code for details!code for details!

SEE ALSO

Locale::TextDomain(3pm), Locale::Messages(3pm), Encode(3pm), perllocale(3pm), POSIX(3pm), perl(1), gettext(1), gettext(3)