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.

specify context for FORMAT
format string
string or numeric argument

display this help and exit
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
alert (BEL)
backspace (BS)
form feed (FF)
new line (LF)
carriage return (CR)
horizontal tab (HT)
vertical tab (VT)
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/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.

July 2025 GNU gettext-runtime 0.26