---
name: "Locale::gettext_xs"
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_xs"
---

# Locale::gettext\_xs(3pm)

XS Implementation of Uniforum Message Translation

## NAME

Locale::gettext\_xs - XS Implementation of Uniforum Message Translation

## SYNOPSIS

```
 use gettext_xs 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\_xs** 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.

The module does not necessarily work on your system.  It depends on the presence of shared libraries that are not always available. The higher-level modules **Locale::TextDomain::**(3), resp.  **Locale::Messages**(3) will fall back to a pure Perl version if  boostrapping **Locale::gettext\_xs** fails.

The interface of **Locale::gettext\_xs** is mostly identical to the pure  Perl version as described in **Locale::gettext\_pp**(3), see there for details. Differences are outlined below.

**Locale::gettext\_xs** is downwards compatible to **Locale::gettext**(3) by Phillip Vandry \<vandry@Mlink.NET\>.  You can use it as replacement for **Locale::gettext**(3).

Please note that directory names passed to the function **bindtextdomain()** are automatically converted from Perl semantics (slash as directory separator) to local semantics (for example the backslash for MS-DOS).

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

The module is based on the work of Phillip Vandry \<vandry@Mlink.NET\> in **Locale::gettext**(3).

## SEE ALSO

[**Locale::TextDomain**(3pm)](/Locale::TextDomain/3pm.md), [**Locale::gettext\_pp**(3pm)](/Locale::gettext_pp/3pm.md), [**Locale::gettext**(3pm)](/Locale::gettext/3pm.md),  [**Locale::Messages**(3pm)](/Locale::Messages/3pm.md), **File::Spec**(3), [**perl**(1)](/perl/1.md)