Locale::gettext_pp

Section: User Contributed Perl Documentation (3pm)
Updated: 2013-01-23
Index Return to Main Contents
 

NAME

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 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

Copyright (C) 2002-2013, Guido Flohr <guido@imperia.net>, all rights reserved. See the source code for details.

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

SEE ALSO

Locale::TextDomain(3pm), Locale::Messages(3pm), Encode(3pm), perllocale(3pm), POSIX(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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
FUNCTIONS
CONSTANTS
EXPORT TAGS
AUTHOR
SEE ALSO
POD ERRORS