d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

printf(1): Add EXAMPLES section

Browse Source 
* Small addition with four simple examples
 * While here, remove three obsolete .Tn macros

Approved by:	manpages (gbe)
Differential Revision:	https://reviews.freebsd.org/D25462
This commit is contained in:
Fernando Apesteguía 2020-07-01 16:33:32 +00:00
parent eeada9221b
commit 5dbd4b8e96
1 changed files with 42 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
usr.bin/printf/printf.1
View File

@ -31,7 +31,7 @@
.\" @(#)printf.1 8.1 (Berkeley) 6/6/93 .\" @(#)printf.1 8.1 (Berkeley) 6/6/93
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd July 29, 2019 .Dd July 1, 2020
.Dt PRINTF 1 .Dt PRINTF 1
.Os .Os
.Sh NAME .Sh NAME
@ -316,12 +316,48 @@ Consult the
manual page. manual page.
.Sh EXIT STATUS .Sh EXIT STATUS
.Ex -std .Ex -std
.Sh EXAMPLES
Print the string
.Qq hello :
.Bd -literal -offset indent
$ printf "%s\en" hello
hello
.Ed
.Pp
Same as above, but notice that the format string is not quoted and hence we
do not get the expected behavior:
.Bd -literal -offset indent
$ printf %s\en hello
hellon$
.Ed
.Pp
Print arguments forcing sign only for the first argument:
.Bd -literal -offset indent
$ printf "%+d\en%d\en%d\en" 1 -2 13
+1
-2
13
.Ed
.Pp
Same as above, but the single format string will be applied to the three
arguments:
.Bd -literal -offset indent
$ printf "%+d\en" 1 -2 13
+1
-2
+13
.Ed
.Pp
Print number using only two digits after the decimal point:
.Bd -literal -offset indent
$ printf "%.2f\en" 31.7456
31.75
.Ed
.Sh COMPATIBILITY .Sh COMPATIBILITY
The traditional The traditional
.Bx .Bx
behavior of converting arguments of numeric formats not beginning behavior of converting arguments of numeric formats not beginning
with a digit to the with a digit to the ASCII
.Tn ASCII
code of the first character is not supported. code of the first character is not supported.
.Sh SEE ALSO .Sh SEE ALSO
.Xr builtin 1 , .Xr builtin 1 ,
@ -343,8 +379,7 @@ It is modeled
after the standard library function, after the standard library function,
.Xr printf 3 . .Xr printf 3 .
.Sh CAVEATS .Sh CAVEATS
.Tn ANSI ANSI hexadecimal character constants were deliberately not provided.
hexadecimal character constants were deliberately not provided.
.Pp .Pp
Trying to print a dash ("-") as the first character causes Trying to print a dash ("-") as the first character causes
.Nm .Nm
@ -364,10 +399,8 @@ and
formats with a precision formats with a precision
may not operate as expected. may not operate as expected.
.Sh BUGS .Sh BUGS
Since the floating point numbers are translated from Since the floating point numbers are translated from ASCII
.Tn ASCII to floating-point and then back again, floating-point precision may be lost.
to floating-point and
then back again, floating-point precision may be lost.
(By default, the number is translated to an IEEE-754 double-precision (By default, the number is translated to an IEEE-754 double-precision
value before being printed. value before being printed.
The The