HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

f
fwprintf(3C) fwprintf(3C)
A field width, or precision, or both, may be indicated by an asterisk (*). In this case an argument of type
int supplies the field width or precision. Arguments specifying field width,orprecision, or both must
appear in that order before the argument, if any, to be converted. A negative field width is taken as a
-
flag followed by a positive field width. A negative precision is taken as if the precision were omitted. In for-
mat wide-character strings containing the
%n$ form of a conversion specification, a field width or precision
may be indicated by the sequence
%n
$, where m is a decimal integer in the range [1, {NL_ARGMAX}]
giving the position in the argument list (after the format argument) of an integer argument containing the
field width or precision, for example:
wprintf(L"%1$d:%2$. *3$d:%4$, *3$d\n", hour, min, precision, sec);
The format can contain either numbered argument specifications (that is,
%n$ and *m$), or unnumbered
argument specifications (that is,
% and
*), but normally not both. The only exception to this is that %% can
be mixed with the
%n$ form. The results of mixing numbered and unnumbered argument specifications in
a format wide-character string are undefined. When numbered argument specifications are used, specify-
ing the Nth argument requires that all the leading arguments, from the first to the (N-1)th, are specified in
the format wide-character string.
The flag wide-characters and their meanings are:
’ The integer portion of the result of a decimal conversion (%i, %d, %u, %g, or %G ) will be
formatted with thousands’ grouping wide-characters. For other conversions the behavior is
undefined. The non-monetary grouping wide-character is used.
- The result of the conversion will be left-justified within the field. The conversion will be
right-justified if this flag is not specified.
+ The result of a signed conversion will always begin with a sign (+ or -). The conversion will
begin with a sign only when a negative value is converted if this flag is not specified.
space If the first wide-character of a signed conversion is not a sign or if a signed conversion
results in no wide-characters, a space will be prefixed to the result. This means that if the
space and + flags both appear, the space flag will be ignored.
# This flag specifies that the value is to be converted to an alternative form. For
o conver-
sion, it increases the precision (if necessary) to force the first digit of the result to be 0. For
x or X conversions, a non-zero result will have 0x (or 0X) prefixed to it. For
e, E, f, g or
G conversions, the result will always contain a radix character, even if no digits follow it.
Without this flag, a radix character appears in the result of these conversions only if a digit
follows it. For g and G conversions, trailing zeros will not be removed from the result as
they normally are. For other conversions, the behavior is undefined.
0 For d, i, o, u, x, X,
e, E, f, g and G conversions, leading zeros (following any indication of
sign or base) are used to pad to the field width; no space padding is performed. If the
0 and
- flags both appear, the 0 flag will be ignored. For d
, i, o, u, x and X conversions, if a
precision is specified, the
0 flag will be ignored. If the 0 and i
flags both appear, the
grouping wide-characters are inserted before zero padding. For other conversions, the
behavior is undefined.
The conversion wide-characters and their meanings are:
d,i The int argument is converted to a signed decimal in the style [-]dddd. The precision
specifies the minimum number of digits to appear; if the value being converted can be
represented in fewer digits, it will be expanded with leading zeros. The default precision is
1. The result of converting 0 with an explicit precision of 0 is no wide-characters.
o The unsigned int argument is converted to unsigned octal format in the style dddd. The
precision specifies the minimum number of digits to appear; if the value being converted
can be represented in fewer digits, it will be expanded with leading zeros. The default pre-
cision is 1. The result of converting 0 with an explicit precision of 0 is no wide-characters.
u The unsigned int argument is converted to unsigned decimal format in the style dddd. The
precision specifies the minimum number of digits to appear; if the value being converted
can be represented in fewer digits, it will be expanded with leading zeros. The default pre-
cision is 1. The result of converting 0 with an explicit precision of 0 is no wide-characters.
x The unsigned int argument is converted to unsigned hexadecimal format in the style IR
dddd ; the letters abcdef are used. The precision specifies the minimum number of digits to
appear; if the value being converted can be represented in fewer digits, it will be expanded
HP-UX 11i Version 2: December 2007 Update − 2 − Hewlett-Packard Company 453