beautypg.com

Zilog Z8F0130 User Manual

Page 476

background image

Appendix B. C Standard Library

UM013037-1212

452

Zilog Developer Studio II – Z8 Encore!
User Manual

sequent arguments. The results are undefined if there are insufficient arguments for the
format. If the format is exhausted while arguments remain, the excess arguments are eval-
uated but otherwise ignored. The

printf

function returns when the end of the format

string is encountered.

Each conversion specification is introduced by the character %. After the %, the following
appear in sequence:

Zero or more flags that modify the meaning of the conversion specification.

An optional decimal integer specifying a minimum field width. If the converted value
has fewer characters than the field width, it is padded on the left (or right, if the left
adjustment flag, described later, has been given) to the field width. The padding is
with spaces unless the field width integer starts with a zero, in which case the padding
is with zeros.

An optional precision that gives the minimum number of digits to appear for the d, i,
o, u, x, and X conversions, the number of digits to appear after the decimal point for e,
E, and f conversions, the maximum number of significant digits for the g and G con-
versions, or the maximum number of characters to be written from a string in s con-
version. The precision takes the form of a period (.) followed by an optional decimal
integer; if the integer is omitted, it is treated as zero. The amount of padding specified
by the precision overrides that specified by the field width.

An optional h specifies that a following d, i, o, u, x, or X conversion character applies
to a short_int or unsigned_short_int argument (the argument has been promoted
according to the integral promotions, and its value is converted to short_int or
unsigned_short_int before printing). An optional l (ell) specifies that a following d, i,
o, u, x or X conversion character applies to a long_int or unsigned_long_int argument.
An optional L specifies that a following e, E, f, g, or G conversion character applies to
a long_double argument. If an h, l, or L appears with any other conversion character, it
is ignored.

A character that specifies the type of conversion to be applied.

A field width or precision, or both, can be indicated by an asterisk * instead of a digit
string. In this case, an int argument supplies the files width or precision. The argu-
ments specifying field width or precision displays before the argument (if any) to be
converted. A negative field width argument is taken as a - flag followed by a positive
field width. A negative precision argument is taken as if it were missing.

For more specific information about the flag characters and conversion characters for the

printf

function, see the

printf Flag Characters

section on page 453 and the

printf Conver-

sion Characters

section on page 454.

Note: