---
name: "Locale::gettext_pp"
section: "3pm"
platform: "linux"
package: "perl-libintl-perl"
version: "1.37-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Locale::gettext_pp"
---

# Locale::gettext\_pp(3pm)

Pure Perl Implementation of Uniforum Message Translation

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

- **setlocale**

  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 qw(':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-2026 Guido Flohr \<http://www.guido-flohr.net/\> (\<mailto:guido.flohr@cantanea.com\>), all rights reserved.  See the source code for details!code for details!

## SEE ALSO

[**Locale::TextDomain**(3pm)](/Locale::TextDomain/3pm.md), [**Locale::Messages**(3pm)](/Locale::Messages/3pm.md), [**Encode**(3pm)](/Encode/3pm.md), **perllocale**(3pm), [**POSIX**(3pm)](/POSIX/3pm.md), [**perl**(1)](/perl/1.md), [**gettext**(1)](/gettext/1.md), [**gettext**(3)](/gettext/3.md)