src/usr.bin/printf/printf.1 - diff

Return to printf.1 CVS log

Up to [local] / src / usr.bin / printf

Diff for /src/usr.bin/printf/printf.1 between version 1.9 and 1.10

version 1.9, 2000/03/06 03:15:59

version 1.10, 2000/03/10 20:17:49

Line 1

.\" $OpenBSD$

.\"

Line 49

Line 50

.Nm printf

formats and prints its arguments, after the first, under control

of the

.Ar format .

The

.Ar format

is a character string which contains three types of objects: plain characters,

which are simply copied to standard output, character escape sequences which

are converted and copied to the standard output, and format specifications,

each of which causes printing of the next successive

.Ar argument .

.Pp

The

.Ar arguments

Line 66

Line 67

.Cm s ;

otherwise it is evaluated as a C constant, with the following extensions:

.Pp

.Bl -bullet -offset indent

.Bl -bullet -offset indent -compact

.It

A leading plus or minus sign is allowed.

.It

Line 77

.El

.Pp

The format string is reused as often as necessary to satisfy the

.Ar arguments .

Any extra format specifications are evaluated with zero or the null

string.

.Pp

Character escape sequences are in backslash notation as defined in

.St -ansiC .

The characters and their meanings

The characters and their meanings are as follows:

are as follows:

.Pp

.Bl -tag -width Ds -offset indent

.Bl -tag -width Ds -offset indent -compact

.It Cm \ee

Write an <escape> character.

.It Cm \ea

Line 117

Each format specification is introduced by the percent

.Pq Sq \&%

character.

The remainder of the format specification includes,

The remainder of the format specifiers include,

in the following order:

.Bl -tag -width Ds

.It "Zero or more of the following flags:"

Line 126

Specifies that the value should be printed in an

.Dq alternate form .

For the

.Cm c ,

.Cm d ,

and

.Cm s

formats, this option has no effect. For the

formats, this option has no effect.

For the

.Cm o

format the precision of the number is increased to force the first

character of the output string to a zero. For the

character of the output string to a zero.

For the

.Cm x

.Pq Cm X

format, a non-zero result has the string

.Li 0x

.Pq Li 0X

prepended to it. For

prepended to it.

.Cm e ,

For

.Cm e ,

.Cm E ,

.Cm f ,

.Cm g ,

and

.Cm G

formats, the result will always contain a decimal point, even if no

digits follow the point (normally, a decimal point only appears in the

results of those formats if a digit follows the decimal point). For

results of those formats if a digit follows the decimal point).

For

.Cm g

and

.Cm G

Line 163

Line 167

a sign placed before the number when using signed formats.

.It Sq \&\ \&

A space specifies that a blank should be left before a positive number

for a signed format. A

for a signed format.

.Dq +

.Ql +

overrides a space if both are used.

.It Cm \&0

A zero character specifies that zero-padding should be used

rather than blank-padding. This flag is ignored if used with a precision

rather than blank-padding.

This flag is ignored if used with a precision

specifier and any of the

.Cm d , i , o , u ,

.Cm x

.Pq Cm X

formats. A

formats.

.Dq \&-

.Ql \&-

overrides a

.Dq \&0

.Ql \&0

if both are used.

.El

.It "Field Width:"

Line 206

Line 213

.El

.Pp

A field width or precision may be

.Dq \&*

.Ql \&*

instead of a digit string.

In this case an

.Ar argument

Line 247

Line 254

the precision specification for the argument; when the precision is

missing, 6 digits are produced.

An upper-case

.Dq E

.Sq E

is used for an

.Cm E

format.

Line 276

Line 283

precision is 0 or missing, all characters in the string are printed.

.It Cm \&%

Print a

.Dq \&% ;

.Ql \&% ;

no argument is used.

.El

.Pp