--- a/Symbian3/PDK/Source/GUID-EC21A1A2-FD5A-5764-A69A-18D74090BA92.dita Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-EC21A1A2-FD5A-5764-A69A-18D74090BA92.dita Tue Mar 30 11:56:28 2010 +0100
@@ -10,7 +10,7 @@
<!DOCTYPE concept
PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-EC21A1A2-FD5A-5764-A69A-18D74090BA92" xml:lang="en"><title>Format
-string syntax</title><shortdesc><apiname>TDes8::Format()</apiname>, <apiname>TDes16::Format()</apiname> and
+string syntax</title><shortdesc><codeph>TDes8::Format()</codeph>, <codeph>TDes16::Format()</codeph> and
some other functions take a format string containing literal text embedded
with directives for converting a trailing list of arguments into text.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p> Each formatting directive consumes a number of arguments from the trailing
@@ -25,12 +25,14 @@
<p>Formatting directives begin with a "<codeph>%</codeph> ". To insert a percentage
sign, use the digraph "<codeph>%%</codeph> ". </p>
<p>Examples of how to use format string syntax are provided in <xref href="GUID-0B6C97D3-0E2D-5BBE-B8AC-985902715160.dita#GUID-0B6C97D3-0E2D-5BBE-B8AC-985902715160/GUID-E0D95020-9E74-5FE1-8A84-74FFE8C2CB1E">Formatting text</xref>. </p>
-<section id="GUID-E6DF6CA4-D6BA-494B-A2B1-CCD63B3DC4A3"><title>Unpadded, dynamic-width formatting </title><codeblock xml:space="preserve">simple-conversion
+<section id="GUID-E6DF6CA4-D6BA-494B-A2B1-CCD63B3DC4A3"><title>Unpadded, dynamic-width
+formatting </title><codeblock xml:space="preserve">simple-conversion
%
conversion-specifier</codeblock><p>Data from the argument list is converted
without padding, and only occupies the space required. The <codeph>conversion
specifier</codeph> describes how the data is to be formatted into a string. </p></section>
-<section id="GUID-35FE3AB2-8B3D-4459-9A8F-8E3688216066"><title>Fixed-width, padded formatting </title><codeblock xml:space="preserve">padded-conversion
+<section id="GUID-35FE3AB2-8B3D-4459-9A8F-8E3688216066"><title>Fixed-width,
+padded formatting </title><codeblock xml:space="preserve">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. </p> </li>
</ul></section>
-<section id="GUID-C4A3149B-B791-4CD8-9E2F-F8BA7D27C0BD"><title>Formatting with alignment, arbitrary pad character and a specified
-field width </title><p>Note that for this formatting conversion, only a zero
-or a space is permitted for the pad character. </p><codeblock xml:space="preserve">aligned-conversion
+<section id="GUID-C4A3149B-B791-4CD8-9E2F-F8BA7D27C0BD"><title>Formatting
+with alignment, arbitrary pad character and a specified field width </title><p>Note
+that for this formatting conversion, only a zero or a space is permitted for
+the pad character. </p><codeblock xml:space="preserve">aligned-conversion
alignment [pad]
field-width [precision]
conversion-specifier</codeblock><p>The full <codeph>aligned-conversion</codeph> 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. </p><p>Undefined terms are discussed below. </p></section>
-<section id="GUID-0E226EE4-FDF2-4ED0-8F4F-82862EEAFE4A"><title>Alignment specifiers</title> <p>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. </p> <p>The <codeph>alignment</codeph> specifier
+<section id="GUID-0E226EE4-FDF2-4ED0-8F4F-82862EEAFE4A"><title>Alignment specifiers</title> <p>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. </p> <p>The <codeph>alignment</codeph> specifier
is a single character with one of the following values: </p> <table id="GUID-D728B8E3-380B-5A78-B4A7-70EBAAB4ACF2">
<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
<thead>
@@ -89,30 +92,31 @@
</tbody>
</tgroup>
</table> </section>
-<section id="GUID-80251801-E0A5-4733-AB94-D3311F005F0D"><title>Field width specifiers</title> <p>Data may be formatted into
-a field with a fixed or a dynamic width. Fixed field widths require an extra
-argument. </p> <p>The <codeph>field-width</codeph> 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 ('<codeph>*</codeph>') character. An
-asterisk indicates that the size of the field is taken from the next <xref href="GUID-F9432D7B-41C9-3048-AC50-B5BCF8BE11D0.dita"><apiname>TUint</apiname></xref> value
-in the argument list. </p> </section>
-<section id="GUID-A7B658B7-E137-4FE0-B70C-F2F439A3E33F"><title>Pad characters</title> <p>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. </p> <p>The <codeph>pad</codeph> character may be
-any non-numeric character (although "<codeph>0</codeph> " can be specified).
+<section id="GUID-80251801-E0A5-4733-AB94-D3311F005F0D"><title>Field width
+specifiers</title> <p>Data may be formatted into a field with a fixed or a
+dynamic width. Fixed field widths require an extra argument. </p> <p>The <codeph>field-width</codeph> 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 ('<codeph>*</codeph>')
+character. An asterisk indicates that the size of the field is taken from
+the next <xref href="GUID-F9432D7B-41C9-3048-AC50-B5BCF8BE11D0.dita"><apiname>TUint</apiname></xref> value in the argument list. </p> </section>
+<section id="GUID-A7B658B7-E137-4FE0-B70C-F2F439A3E33F"><title>Pad characters</title> <p>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. </p> <p>The <codeph>pad</codeph> character
+may be any non-numeric character (although "<codeph>0</codeph> " can be specified).
If the pad character is an asterisk ("<codeph>*</codeph> "), then the next
argument in the list is read, interpreted as a <codeph>TUint</codeph>, and
used as the pad character. </p> </section>
-<section id="GUID-D7578AD1-9749-441E-B7E3-13170B961F1C"><title>Precision specifiers</title> <p>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. </p> <p>If the precision
-specifier is omitted, conversion defaults to <codeph>KDefaultPrecision</codeph> decimal
+<section id="GUID-D7578AD1-9749-441E-B7E3-13170B961F1C"><title>Precision specifiers</title> <p>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. </p> <p>If
+the precision specifier is omitted, conversion defaults to <codeph>KDefaultPrecision</codeph> decimal
places. </p> </section>
-<section id="GUID-B317D693-E5B6-4F6F-90D3-5576B894DEAD"><title>Variable argument positions</title> <p>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. </p> <p>Immediately after
-the initial <codeph>%</codeph> character preceding every conversion specifier, <codeph>$</codeph> <i>x</i> <codeph>$</codeph> may
+<section id="GUID-B317D693-E5B6-4F6F-90D3-5576B894DEAD"><title>Variable argument
+positions</title> <p>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. </p> <p>Immediately after the initial <codeph>%</codeph> character
+preceding every conversion specifier, <codeph>$</codeph> <i>x</i> <codeph>$</codeph> may
optionally be specified, where <i>x</i> 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 @@
</tbody>
</tgroup>
</table> </section>
-<section id="GUID-D2A688DE-C73C-4086-946A-9A9724D04252"><title>Notes</title> <p>Using an asterisk for both <codeph>field-width</codeph> and <codeph>pad</codeph> means
+<section id="GUID-D2A688DE-C73C-4086-946A-9A9724D04252"><title>Notes</title> <p>Using
+an asterisk for both <codeph>field-width</codeph> and <codeph>pad</codeph> means
that the width value and the pad character will be taken from the argument
list. Note that the first '<codeph>*</codeph>' will be interpreted as representing
the width only if it is preceded by one of the alignment characters '<codeph>+</codeph>'