Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                

printf - Man Page

format and print data

Examples (TL;DR)

  • Print a text message: printf "%s\n" "Hello world"
  • Print an integer in bold blue: printf "\e[1;34m%.3d\e[0m\n" 42
  • Print a float number with the Unicode Euro sign: printf "\u20AC %.2f\n" 123.4
  • Print a text message composed with environment variables: printf "var1: %s\tvar2: %s\n" "$VAR1" "$VAR2"
  • Store a formatted message in a variable (does not work on Zsh): printf -v myvar "This is %s = %d\n" "a year" 2016
  • Print a hexadecimal, octal and scientific number: printf "hex=%x octal=%o scientific=%e" 0xFF 0377 100000

Synopsis

printf FORMAT [ARGUMENT]...
printf OPTION

Description

Print ARGUMENT(s) according to FORMAT, or execute according to OPTION:

--help

display this help and exit

--version

output version information and exit

FORMAT controls the output as in C printf.  Interpreted sequences are:

\"

double quote

\\

backslash

\a

alert (BEL)

\b

backspace

\c

produce no further output

\e

escape

\f

form feed

\n

new line

\r

carriage return

\t

horizontal tab

\v

vertical tab

\NNN

byte with octal value NNN (1 to 3 digits)

\xHH

byte with hexadecimal value HH (1 to 2 digits)

\uHHHH

Unicode (ISO/IEC 10646) character with hex value HHHH (4 digits)

\UHHHHHHHH

Unicode character with hex value HHHHHHHH (8 digits)

%%

a single %

%b

ARGUMENT as a string with '\' escapes interpreted, except that octal escapes are of the form \0 or \0NNN

%q

ARGUMENT is printed in a format that can be reused as shell input, escaping non-printable characters with the proposed POSIX $'' syntax.

and all C format specifications ending with one of diouxXfeEgGcs, with ARGUMENTs converted to proper type first.  Variable widths are handled.

Your shell may have its own version of printf, which usually supersedes the version described here.  Please refer to your shell's documentation for details about the options it supports.

Author

Written by David MacKenzie.

Reporting Bugs

GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
Report any translation bugs to <https://translationproject.org/team/>

See Also

printf(3)

Full documentation <https://www.gnu.org/software/coreutils/printf>
or available locally via: info '(coreutils) printf invocation'

Referenced By

bash(1), dash(1), echo(1), fetchlog(1), git-sh-i18n(1), herbstluftwm(1), ksh93(1), lksh(1), printf(3), ps(1), spax(1), zshcompsys(1).

September 2024 GNU coreutils 9.5