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.

       -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-1997, 2000-2023 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.22.4.tar.gz fetched from
       ⟨https://ftp.gnu.org/gnu/gettext/⟩ on 2023-12-22.  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.22.2   September 2023                  NGETTEXT(1)

HTML rendering created 2023-12-22 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