ngettext(1)

ngettext1

Translate message and choose plural form

Usage

ngettext [OPTION] [TEXTDOMAIN] MSGID MSGID-PLURAL COUNT

Overview

The ngettext program translates a natural language message into the user's language, by looking up the translation in a message catalog, and chooses the appropriate plural form, which depends on the number COUNT and the language of the message catalog where the translation was found.

Display native language translation of a textual message whose grammatical form depends on a number.

Options and arguments:

-d, --domain=TEXTDOMAIN

retrieve translated message from TEXTDOMAIN

-c, --context=CONTEXT

specify context for MSGID

-e

enable expansion of some escape sequences

-E

(ignored for compatibility)

[TEXTDOMAIN]

retrieve translated message from TEXTDOMAIN

MSGID MSGID-PLURAL

translate MSGID (singular) / MSGID-PLURAL (plural)

COUNT

choose singular/plural form based on this value

Informative output:

-h, --help

display this help and exit

-V, --version

display version information and exit

If the TEXTDOMAIN parameter is not given, the domain is determined from the environment variable TEXTDOMAIN. If the message catalog is not found in the regular directory, another location can be specified with the environment variable TEXTDOMAINDIR. Standard search directory: /usr/share/locale

Releases

13 releases since Debian 3.0 (Woody); the text changed 10 times.

  1. 3.0
  2. 3.1
  3. 4.0
  4. 5.0
  5. 6.0–7
  6. 8
  7. 9–10
  8. 11
  9. 12
  10. 13
  11. Arch

--context since Debian 11 (Bullseye); -c since Debian 11 (Bullseye).

Author

Written by Ulrich Drepper and Bruno Haible.

Reporting bugs

Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext> or by email to <[email protected]>.

From gettext 1.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.