|
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. |
|
|
NAME | SYNOPSIS | DESCRIPTION | AUTHOR | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON |
|
|
|
PRINTF_GETTEXT(1) User Commands PRINTF_GETTEXT(1)
printf_gettext - translate format string and apply it
printf_gettext [OPTION] FORMAT [ARGUMENT]...
The printf_gettext program translates a format string into the
user's language, by looking up the translation in a message
catalog, and applies the translated format string to the specified
arguments.
Produces formatted output, applying the native language
translation of FORMAT to the ARGUMENTs.
Options and arguments:
-c, --context=CONTEXT
specify context for FORMAT
FORMAT format string
ARGUMENT
string or numeric argument
Informative output:
-h, --help
display this help and exit
-V, --version
display version information and exit
The format string consists of
- plain text, - directives, that start with '%', - escape
sequences, that start with a backslash.
A directive that consumes an argument
- starts with '%' or '%m$' where m is a positive integer, -
is optionally followed by any of the characters '#', '0',
'-', ' ', '+',
each of which acts as a flag,
- is optionally followed by a width specification (a
nonnegative integer), - is optionally followed by '.' and a
precision specification (an optional
nonnegative integer),
- is finished by a specifier
- '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.
Additionally there is the directive '%%', that prints a single
'%'.
If a directive specifies the argument by its number ('%m$'
notation), all directives that consume an argument must do so.
The escape sequences are:
\\ backslash
\a alert (BEL)
\b backspace (BS)
\f form feed (FF)
\n new line (LF)
\r carriage return (CR)
\t horizontal tab (HT)
\v vertical tab (VT)
\nnn octal number with 1 to 3 octal digits
Environment variables:
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/local/share/locale
Written by Bruno Haible.
Report bugs in the bug tracker at
<https://savannah.gnu.org/projects/gettext> or by email to
<bug-gettext@gnu.org>.
Copyright © 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.
The full documentation for printf_gettext is maintained as a
Texinfo manual. If the info and printf_gettext programs are
properly installed at your site, the command
info printf_gettext
should give you access to the complete manual.
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 PRINTF_GETTEXT(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. |
|