.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.6.
.TH PRINTF_NGETTEXT "1" "July 2025" "GNU gettext-runtime 0.26" "User Commands"
.SH NAME
printf_ngettext \- translate format string and apply it
.SH SYNOPSIS
.B printf_ngettext
[\fI\,OPTION\/\fR] \fI\,FORMAT FORMAT-PLURAL COUNT \/\fR[\fI\,ARGUMENT\/\fR]...
.SH DESCRIPTION
.\" Add any additional description here
The \fBprintf_ngettext\fP program translates a format string into the user's
language, by looking up the translation in a message catalog and then
choosing the appropriate plural form, which depends on the number \fICOUNT\fP
and the language of the message catalog where the translation was found, and
applies the translated format string to the specified arguments.
.PP
Produces formatted output, applying the native language translation of FORMAT
and FORMAT\-PLURAL, depending on COUNT, to the ARGUMENTs.
.SS "Options and arguments:"
.TP
\fB\-c\fR, \fB\-\-context\fR=\fI\,CONTEXT\/\fR
specify context for FORMAT
.TP
FORMAT
English singular form of format string
.TP
FORMAT\-PLURAL
English plural form of format string
.TP
COUNT
choose singular/plural form based on this value
.TP
ARGUMENT
string or numeric argument
.SS "Informative output:"
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
display version information and exit
.PP
Each format string consists of
.IP
\- plain text,
\- directives, that start with '%',
\- escape sequences, that start with a backslash.
.PP
A directive that consumes an argument
.IP
\- starts with '%' or '%m$' where m is a positive integer,
\- is optionally followed by any of the characters '#', '0', '\-', ' ', '+',
.IP
each of which acts as a flag,
.IP
\- is optionally followed by a width specification (a nonnegative integer),
\- is optionally followed by '.' and a precision specification (an optional
.IP
nonnegative integer),
.IP
\- is finished by a specifier
.IP
\- 'c', that prints a character,
\- 's', that prints a string,
\- 'i', 'd', that print an integer,
\- 'u', 'o', 'x', 'X', that print an unsigned (nonnegative) integer,
\- 'e', 'E', that print a floating\-point number in scientific notation,
\- 'f', 'F', that print a floating\-point number without an exponent,
\- 'g', 'G', that print a floating\-point number in general notation,
\- 'a', 'A', that print a floating\-point number in hexadecimal notation.
.PP
Additionally there is the directive '%%', that prints a single '%'.
.PP
If a directive specifies the argument by its number ('%m$' notation),
all directives that consume an argument must do so.
.PP
The escape sequences are:
.TP
\e\e
backslash
.TP
\ea
alert (BEL)
.TP
\eb
backspace (BS)
.TP
\ef
form feed (FF)
.TP
\en
new line (LF)
.TP
\er
carriage return (CR)
.TP
\et
horizontal tab (HT)
.TP
\ev
vertical tab (VT)
.TP
\ennn
octal number with 1 to 3 octal digits
.PP
Environment variables:
.PP
The translation of the format string is looked up in the translation domain
given by the environment variable TEXTDOMAIN.
It is looked up in the catalogs directory given by the environment variable
TEXTDOMAINDIR or, if not present, in the default catalogs directory.
This binary is configured to use the default catalogs directory:
/usr/share/locale
.SH AUTHOR
Written by Bruno Haible.
.SH "REPORTING BUGS"
Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext>
or by email to <bug\-gettext@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2025 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B printf_ngettext
is maintained as a Texinfo manual.  If the
.B info
and
.B printf_ngettext
programs are properly installed at your site, the command
.IP
.B info printf_ngettext
.PP
should give you access to the complete manual.