Format -string syntax

Each formatting directive consumes a number of arguments from the trailing @@ -25,12 +25,14 @@

Formatting directives begin with a "% ". To insert a percentage sign, use the digraph "%% ".

Unpadded, dynamic-width formatting simple-conversion +

Unpadded, dynamic-width +formatting simple-conversion % conversion-specifier

Data from the argument list is converted without padding, and only occupies the space required. The conversion specifier describes how the data is to be formatted into a string.

Fixed-width, padded formatting padded-conversion +

Fixed-width, +padded formatting padded-conversion % zero-or-space-pad field-width @@ -53,18 +55,19 @@ is anything else, then the number of converted characters is limited to the width value.

Formatting with alignment, arbitrary pad character and a specified -field width

Note that for this formatting conversion, only a zero -or a space is permitted for the pad character.

aligned-conversion +

Formatting +with alignment, arbitrary pad character and a specified field width

Note +that for this formatting conversion, only a zero or a space is permitted for +the pad character.

aligned-conversion alignment [pad] field-width [precision] conversion-specifier

The full aligned-conversion is verbose, but in addition to the zero and space characters, it permits non-numeric characters to be specified as the padding character. It also permits its value to be aligned within the field.

Undefined terms are discussed below.

Alignment specifiers

Formatted data whose width -in characters is less than the width of the field can optionally be aligned -to the left, or to the centre of the field. The default is right-alignment.

The alignment specifier +

Alignment specifiers

Formatted +data whose width in characters is less than the width of the field can optionally +be aligned to the left, or to the centre of the field. The default is right-alignment.

The alignment specifier is a single character with one of the following values:

@@ -89,30 +92,31 @@

Field width specifiers

Data may be formatted into -a field with a fixed or a dynamic width. Fixed field widths require an extra -argument.

The field-width specifier is either a sequence -of decimal digits which explicitly define the size of the field to be occupied -by the converted data, or an asterisk ('*') character. An -asterisk indicates that the size of the field is taken from the next TUint value -in the argument list.

Pad characters

Formatted data whose width in characters -is less than the width of the field can optionally be padded with as many -characters as are needed.

The pad character may be -any non-numeric character (although "0 " can be specified). +

Field width +specifiers

Data may be formatted into a field with a fixed or a +dynamic width. Fixed field widths require an extra argument.

The field-width specifier +is either a sequence of decimal digits which explicitly define the size of +the field to be occupied by the converted data, or an asterisk ('*') +character. An asterisk indicates that the size of the field is taken from +the next TUint value in the argument list.

Pad characters

Formatted +data whose width in characters is less than the width of the field can optionally +be padded with as many characters as are needed.

The pad character +may be any non-numeric character (although "0 " can be specified). If the pad character is an asterisk ("* "), then the next argument in the list is read, interpreted as a TUint, and used as the pad character.

Precision specifiers

A dot after a field width -introduces a precision specifier. This is only useful when formatting real -values. Precision specifiers are integers whose decimal values specify the -number of decimal places to use when formatting the data.

If the precision -specifier is omitted, conversion defaults to KDefaultPrecision decimal +

Precision specifiers

A +dot after a field width introduces a precision specifier. This is only useful +when formatting real values. Precision specifiers are integers whose decimal +values specify the number of decimal places to use when formatting the data.

If +the precision specifier is omitted, conversion defaults to KDefaultPrecision decimal places.

Variable argument positions

The format string syntax -was extended in v7.0 to include a way of specifying which argument or argument -block should correspond to a conversion specifier.

Immediately after -the initial % character preceding every conversion specifier, $ x $ may +

Variable argument +positions

The format string syntax was extended in v7.0 to include +a way of specifying which argument or argument block should correspond to +a conversion specifier.

Immediately after the initial % character +preceding every conversion specifier, $ x $ may optionally be specified, where x is an integer greater than zero. This integer is used as a one-based index indicating which argument or block of arguments in the argument list should be used for that conversion specifier. @@ -290,7 +294,8 @@

Notes

Using an asterisk for both field-width and pad means +

Notes

Using +an asterisk for both field-width and pad means that the width value and the pad character will be taken from the argument list. Note that the first '*' will be interpreted as representing the width only if it is preceded by one of the alignment characters '+'