man7.org > Linux > man-pages

Linux/UNIX system programming training

ngettext(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | AUTHOR | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON 

NGETTEXT(1)                   User Commands                   NGETTEXT(1)

NAME         top

       ngettext - translate message and choose plural form

SYNOPSIS         top

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

DESCRIPTION         top

       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/local/share/locale

AUTHOR         top

       Written by Ulrich Drepper.

REPORTING BUGS         top

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

COPYRIGHT         top

       Copyright © 1995-2025 Free Software Foundation, Inc.  License
       GPLv3+: GNU GPL version 3 or later
       <https://gnu.org/licenses/gpl.html>
       This is free software: you are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.

SEE ALSO         top

       The full documentation for ngettext is maintained as a Texinfo
       manual.  If the info and ngettext programs are properly installed
       at your site, the command

              info ngettext

       should give you access to the complete manual.

COLOPHON         top

       This page is part of the gettext (message translation) project.
       Information about the project can be found at 
       ⟨http://www.gnu.org/software/gettext/⟩.  If you have a bug report
       for this manual page, see
       ⟨http://savannah.gnu.org/projects/gettext/⟩.  This page was
       obtained from the tarball gettext-0.26.tar.gz fetched from
       ⟨https://ftp.gnu.org/gnu/gettext/⟩ on 2025-08-11.  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a
       mail to man-pages@man7.org

GNU gettext-runtime 0.26        July 2025                     NGETTEXT(1)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI