summaryrefslogtreecommitdiff
path: root/man/printf.1
blob: 696ea7e1f621fe6f53b286b07e34ffd1b0bdda55 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH PRINTF "1" "March 2007" "GNU coreutils 6.9" "User Commands"
.SH NAME
printf \- format and print data
.SH SYNOPSIS
.B printf
\fIFORMAT \fR[\fIARGUMENT\fR]...
.br
.B printf
\fIOPTION\fR
.SH DESCRIPTION
.\" Add any additional description here
.PP
Print ARGUMENT(s) according to FORMAT.
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
FORMAT controls the output as in C printf.  Interpreted sequences are:
.TP
\e"
double quote
.TP
\eNNN
character with octal value NNN (1 to 3 digits)
.TP
\e\e
backslash
.TP
\ea
alert (BEL)
.TP
\eb
backspace
.TP
\ec
produce no further output
.TP
\ef
form feed
.TP
\en
new line
.TP
\er
carriage return
.TP
\et
horizontal tab
.TP
\ev
vertical tab
.TP
\exHH
byte with hexadecimal value HH (1 to 2 digits)
.TP
\euHHHH
Unicode (ISO/IEC 10646) character with hex value HHHH (4 digits)
.TP
\eUHHHHHHHH
Unicode character with hex value HHHHHHHH (8 digits)
.TP
%%
a single %
.TP
%b
ARGUMENT as a string with `\e' escapes interpreted,
except that octal escapes are of the form \e0 or \e0NNN
.PP
and all C format specifications ending with one of diouxXfeEgGcs, with
ARGUMENTs converted to proper type first.  Variable widths are handled.
.PP
NOTE: 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.
.SH AUTHOR
Written by David MacKenzie.
.SH "REPORTING BUGS"
Report bugs to <bug\-coreutils@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2007 Free Software Foundation, Inc.
.br
This is free software.  You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B printf
is maintained as a Texinfo manual.  If the
.B info
and
.B printf
programs are properly installed at your site, the command
.IP
.B info printf
.PP
should give you access to the complete manual.