Symbian3/Examples/guid-6013a680-57f9-415b-8851-c4fa63356636/_modifier_8cpp-source.html
week 10 bug fix submission: Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>TB10.1 Example Applications: examples/Base/BufsAndStrings/Desc/Modifier/Modifier.cpp Source File</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.3 -->
<h1>examples/Base/BufsAndStrings/Desc/Modifier/Modifier.cpp</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// Copyright (c) 2000-2009 Nokia Corporation and/or its subsidiary(-ies).</span>
<a name="l00002"></a>00002 <span class="comment">// All rights reserved.</span>
<a name="l00003"></a>00003 <span class="comment">// This component and the accompanying materials are made available</span>
<a name="l00004"></a>00004 <span class="comment">// under the terms of "Eclipse Public License v1.0"</span>
<a name="l00005"></a>00005 <span class="comment">// which accompanies this distribution, and is available</span>
<a name="l00006"></a>00006 <span class="comment">// at the URL "http://www.eclipse.org/legal/epl-v10.html".</span>
<a name="l00007"></a>00007 <span class="comment">//</span>
<a name="l00008"></a>00008 <span class="comment">// Initial Contributors:</span>
<a name="l00009"></a>00009 <span class="comment">// Nokia Corporation - initial contribution.</span>
<a name="l00010"></a>00010 <span class="comment">//</span>
<a name="l00011"></a>00011 <span class="comment">// Contributors:</span>
<a name="l00012"></a>00012 <span class="comment">//</span>
<a name="l00013"></a>00013 <span class="comment">// Description:</span>
<a name="l00014"></a>00014 <span class="comment">// Examples to demonstrate some of the modifying member</span>
<a name="l00015"></a>00015 <span class="comment">// functions of descriptors.</span>
<a name="l00016"></a>00016 <span class="comment">//</span>
<a name="l00017"></a>00017
<a name="l00018"></a>00018 <span class="preprocessor">#include "CommonFramework.h"</span>
<a name="l00019"></a>00019
<a name="l00020"></a>00020 <span class="comment">//</span>
<a name="l00021"></a>00021 <span class="comment">// Common literal text </span>
<a name="l00022"></a>00022 <span class="comment">//</span>
<a name="l00023"></a>00023 _LIT(KPressAnyKeyToContinue,<span class="stringliteral">" (press any key to continue)\n"</span>);
<a name="l00024"></a>00024 _LIT(KTextHelloWorld,<span class="stringliteral">"Hello World!"</span>);
<a name="l00025"></a>00025 _LIT(KTextHello,<span class="stringliteral">"Hello"</span>);
<a name="l00026"></a>00026 _LIT(KTextXYZ,<span class="stringliteral">"XYZ"</span>);
<a name="l00027"></a>00027 _LIT(KTextDinner,<span class="stringliteral">"D\214ner \205 la Fran\207ais"</span>);
<a name="l00028"></a>00028
<a name="l00029"></a>00029 <span class="comment">//</span>
<a name="l00030"></a>00030 <span class="comment">// Common format strings</span>
<a name="l00031"></a>00031 <span class="comment">//</span>
<a name="l00032"></a>00032
<a name="l00033"></a>00033 _LIT(KFormatfourex,<span class="stringliteral">"%4x"</span>);
<a name="l00034"></a>00034 _LIT(KFormatBufLenSizeMax,<span class="stringliteral">"\"%S\"; %d; %d; %d\n"</span>);
<a name="l00035"></a>00035 _LIT(KFormatLenSizeMax,<span class="stringliteral">"; %d; %d; %d\n"</span>);
<a name="l00036"></a>00036 _LIT(KFormatBufLen,<span class="stringliteral">"\"%S\"; Length()=%d; "</span>);
<a name="l00037"></a>00037 _LIT(KFormatSizeMax,<span class="stringliteral">"Size()=%d; MaxLength()=%d\n"</span>);
<a name="l00038"></a>00038 _LIT(KFormatCommon,<span class="stringliteral">"0x%02x "</span>);
<a name="l00039"></a>00039
<a name="l00040"></a>00040 <span class="comment">// Define and implement</span>
<a name="l00041"></a>00041 <span class="comment">// the overflow handler used</span>
<a name="l00042"></a>00042 <span class="comment">// by the AppendFormat() example.</span>
<a name="l00043"></a>00043
<a name="l00044"></a>00044 <span class="keyword">class </span>TestOverflow : <span class="keyword">public</span> TDesOverflow
<a name="l00045"></a>00045 {
<a name="l00046"></a>00046 <span class="keywordtype">void</span> Overflow(TDes& aDes);
<a name="l00047"></a>00047 };
<a name="l00048"></a>00048
<a name="l00049"></a>00049
<a name="l00050"></a>00050 <span class="keywordtype">void</span> TestOverflow::Overflow(TDes& aDes)
<a name="l00051"></a>00051 {
<a name="l00052"></a>00052 _LIT(KTextDescOverflow,<span class="stringliteral">"Descriptor overflow - maxlength %d\n"</span>);
<a name="l00053"></a>00053 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTextDescOverflow,aDes.MaxLength());
<a name="l00054"></a>00054 }
<a name="l00055"></a>00055
<a name="l00056"></a>00056
<a name="l00057"></a>00057 <span class="comment">// Do the example</span>
<a name="l00058"></a>00058 LOCAL_C <span class="keywordtype">void</span> doExampleL()
<a name="l00059"></a>00059 {
<a name="l00060"></a>00060
<a name="l00061"></a>00061 TInt index;
<a name="l00062"></a>00062 TInt counter;
<a name="l00063"></a>00063
<a name="l00064"></a>00064 <span class="comment">// Use a TBuf to demonstrate some of these</span>
<a name="l00065"></a>00065 TBuf<32> buf(KTextHelloWorld);
<a name="l00066"></a>00066
<a name="l00067"></a>00067 <span class="comment">// </span>
<a name="l00068"></a>00068 <span class="comment">// Copy(),CopyF(), CopyUC() & CopyCP() * * * </span>
<a name="l00069"></a>00069 <span class="comment">//</span>
<a name="l00070"></a>00070 <span class="comment">// Note that CopyF() CopyUC() & CopyCP() are locale dependent</span>
<a name="l00071"></a>00071
<a name="l00072"></a>00072 _LIT(KTitleCopy,<span class="stringliteral">"\n--->Copy(),CopyF(),CopyUC() & CopyCP()\n"</span>);
<a name="l00073"></a>00073 _LIT(KNoteAboutLocale1,<span class="stringliteral">"\nNote that the behaviour of CopyF(), CopyUC() & CopyCP() is\n"</span>);
<a name="l00074"></a>00074 _LIT(KNoteAboutLocale2,<span class="stringliteral">"dependent on the locale.\n"</span>);
<a name="l00075"></a>00075 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleCopy);
<a name="l00076"></a>00076 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KNoteAboutLocale1);
<a name="l00077"></a>00077 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KNoteAboutLocale2);
<a name="l00078"></a>00078
<a name="l00079"></a>00079 <span class="comment">// Show buf's content,length,size and</span>
<a name="l00080"></a>00080 <span class="comment">// maximum size.</span>
<a name="l00081"></a>00081 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00082"></a>00082 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00083"></a>00083
<a name="l00084"></a>00084 <span class="comment">// Copy normal</span>
<a name="l00085"></a>00085 buf.Copy(KTextDinner);
<a name="l00086"></a>00086
<a name="l00087"></a>00087 <span class="comment">// Show buf's content,length,size and </span>
<a name="l00088"></a>00088 <span class="comment">// maximum size.</span>
<a name="l00089"></a>00089 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00090"></a>00090 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00091"></a>00091
<a name="l00092"></a>00092
<a name="l00093"></a>00093 <span class="comment">// Copy folded - accents are not preserved</span>
<a name="l00094"></a>00094 <span class="comment">//</span>
<a name="l00095"></a>00095 <span class="comment">// (NB the display may use a different code</span>
<a name="l00096"></a>00096 <span class="comment">// page to that used by the base, in which </span>
<a name="l00097"></a>00097 <span class="comment">// case the accents will seem to be preserved)</span>
<a name="l00098"></a>00098 buf.CopyF(KTextDinner);
<a name="l00099"></a>00099
<a name="l00100"></a>00100 <span class="comment">// Show buf's new content,length,size</span>
<a name="l00101"></a>00101 <span class="comment">// and max size</span>
<a name="l00102"></a>00102 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00103"></a>00103 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00104"></a>00104 <span class="comment">// Copy uppercase</span>
<a name="l00105"></a>00105 <span class="comment">// Note that accents are preserved.</span>
<a name="l00106"></a>00106 buf.CopyUC(KTextDinner);
<a name="l00107"></a>00107
<a name="l00108"></a>00108 <span class="comment">// Show buf's new content,length,size</span>
<a name="l00109"></a>00109 <span class="comment">// and maximum size</span>
<a name="l00110"></a>00110 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00111"></a>00111 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00112"></a>00112
<a name="l00113"></a>00113 <span class="comment">// Copy capitalised</span>
<a name="l00114"></a>00114 <span class="comment">// Note that accents are preserved.</span>
<a name="l00115"></a>00115 _LIT(KTextCatOnMat,<span class="stringliteral">"tHe CaT sAt On ThE mAt - voil\205"</span>);
<a name="l00116"></a>00116 buf.CopyCP(KTextCatOnMat);
<a name="l00117"></a>00117
<a name="l00118"></a>00118 <span class="comment">// Show buf's new content,length,size</span>
<a name="l00119"></a>00119 <span class="comment">// and max size</span>
<a name="l00120"></a>00120 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00121"></a>00121 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00122"></a>00122
<a name="l00123"></a>00123 <span class="comment">// Length of copied text > 32 causes panic !!</span>
<a name="l00124"></a>00124 <span class="comment">// </span>
<a name="l00125"></a>00125 <span class="comment">// Remove the "//" marks on the next two lines</span>
<a name="l00126"></a>00126 <span class="comment">// to see this happen</span>
<a name="l00127"></a>00127 <span class="comment">//_LIT(KTxtCausePanic1,"Panic caused by an attempt to replace text.");</span>
<a name="l00128"></a>00128 <span class="comment">//buf.Copy(KTxtCausePanic1);</span>
<a name="l00129"></a>00129
<a name="l00130"></a>00130 <span class="comment">//</span>
<a name="l00131"></a>00131 <span class="comment">// Append() & operator+= * * * * * * * * * </span>
<a name="l00132"></a>00132 <span class="comment">//</span>
<a name="l00133"></a>00133 _LIT(KTitleAppend,<span class="stringliteral">"\n--->Append & Operator+="</span>);
<a name="l00134"></a>00134 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleAppend);
<a name="l00135"></a>00135 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l00136"></a>00136 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l00137"></a>00137
<a name="l00138"></a>00138 <span class="comment">// Show buf's content,length,size and</span>
<a name="l00139"></a>00139 <span class="comment">// maximum size.</span>
<a name="l00140"></a>00140 buf = KTextHelloWorld;
<a name="l00141"></a>00141 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00142"></a>00142 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00143"></a>00143
<a name="l00144"></a>00144 <span class="comment">// Append:</span>
<a name="l00145"></a>00145 <span class="comment">// 1. a single character</span>
<a name="l00146"></a>00146 <span class="comment">// 2. a descriptor</span>
<a name="l00147"></a>00147 <span class="comment">// 3. another descrptor using operator +=</span>
<a name="l00148"></a>00148 <span class="comment">//</span>
<a name="l00149"></a>00149 <span class="comment">// Generates the string</span>
<a name="l00150"></a>00150 <span class="comment">// "Hello World!@XYZ##" in buf</span>
<a name="l00151"></a>00151 buf.Append(<span class="charliteral">'@'</span>);
<a name="l00152"></a>00152 buf.Append(KTextXYZ);
<a name="l00153"></a>00153 _LIT(KTextHashHash,<span class="stringliteral">"##"</span>);
<a name="l00154"></a>00154 buf += KTextHashHash;
<a name="l00155"></a>00155 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00156"></a>00156 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00157"></a>00157
<a name="l00158"></a>00158 <span class="comment">// </span>
<a name="l00159"></a>00159 <span class="comment">// Swap() * * * * * * * * * * * * * * * </span>
<a name="l00160"></a>00160 <span class="comment">//</span>
<a name="l00161"></a>00161 _LIT(KTitleSwap,<span class="stringliteral">"\n--->Swap()"</span>);
<a name="l00162"></a>00162 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleSwap);
<a name="l00163"></a>00163 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l00164"></a>00164 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l00165"></a>00165
<a name="l00166"></a>00166 _LIT(KWhatANiceDay,<span class="stringliteral">"What a nice day"</span>);
<a name="l00167"></a>00167 TBuf<16> altbuf1(KWhatANiceDay);
<a name="l00168"></a>00168 buf = KTextHelloWorld;
<a name="l00169"></a>00169
<a name="l00170"></a>00170 <span class="comment">// Show buf and altbuf BEFORE swap</span>
<a name="l00171"></a>00171 _LIT(KTextBefore,<span class="stringliteral">" BEFORE...\n"</span>);
<a name="l00172"></a>00172 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTextBefore);
<a name="l00173"></a>00173 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00174"></a>00174 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00175"></a>00175
<a name="l00176"></a>00176 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&altbuf1,altbuf1.Length());
<a name="l00177"></a>00177 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,altbuf1.Size(),altbuf1.MaxLength());
<a name="l00178"></a>00178
<a name="l00179"></a>00179 <span class="comment">// now swap the descriptors and look at</span>
<a name="l00180"></a>00180 <span class="comment">// buf and altbuf again;</span>
<a name="l00181"></a>00181 <span class="comment">// The content, length and size of the </span>
<a name="l00182"></a>00182 <span class="comment">// descriptors have swapped; their maximum </span>
<a name="l00183"></a>00183 <span class="comment">// lengths have NOT changed.</span>
<a name="l00184"></a>00184 buf.Swap(altbuf1);
<a name="l00185"></a>00185
<a name="l00186"></a>00186 _LIT(KTextAfter,<span class="stringliteral">" AFTER...\n"</span>);
<a name="l00187"></a>00187 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTextAfter);
<a name="l00188"></a>00188 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00189"></a>00189 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00190"></a>00190
<a name="l00191"></a>00191 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&altbuf1,altbuf1.Length());
<a name="l00192"></a>00192 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,altbuf1.Size(),altbuf1.MaxLength()
<a name="l00193"></a>00193 );
<a name="l00194"></a>00194
<a name="l00195"></a>00195 <span class="comment">// Swap is ok provided the maximum length</span>
<a name="l00196"></a>00196 <span class="comment">// of each descriptor is big enough to </span>
<a name="l00197"></a>00197 <span class="comment">// hold the other's data.</span>
<a name="l00198"></a>00198
<a name="l00199"></a>00199 <span class="comment">// altbuf2 is too small to accommodate </span>
<a name="l00200"></a>00200 <span class="comment">// buf's data !!</span>
<a name="l00201"></a>00201 <span class="comment">// </span>
<a name="l00202"></a>00202 <span class="comment">// Remove the "//" marks on the next three lines</span>
<a name="l00203"></a>00203 <span class="comment">// to see this panic</span>
<a name="l00204"></a>00204 <span class="comment">//_LIT(KTxtxxx,"xxx");</span>
<a name="l00205"></a>00205 <span class="comment">//TBuf<8> altbuf2(KTxtxxx);</span>
<a name="l00206"></a>00206 <span class="comment">//buf = KTextHelloWorld;</span>
<a name="l00207"></a>00207 <span class="comment">//buf.Swap(altbuf2);</span>
<a name="l00208"></a>00208
<a name="l00209"></a>00209
<a name="l00210"></a>00210 <span class="comment">// </span>
<a name="l00211"></a>00211 <span class="comment">// Repeat() * * * * * * * * * * * * * * * </span>
<a name="l00212"></a>00212 <span class="comment">//</span>
<a name="l00213"></a>00213 _LIT(KTitleRepeat,<span class="stringliteral">"\n--->Repeat()"</span>);
<a name="l00214"></a>00214 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleRepeat);
<a name="l00215"></a>00215 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l00216"></a>00216 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l00217"></a>00217
<a name="l00218"></a>00218 <span class="comment">// Set current length of buf to 16 and</span>
<a name="l00219"></a>00219 <span class="comment">// copy repeat the characters "Hello".</span>
<a name="l00220"></a>00220 <span class="comment">// The descriptor is filled up to </span>
<a name="l00221"></a>00221 <span class="comment">// its CURRENT LENGTH.</span>
<a name="l00222"></a>00222 <span class="comment">// Result is the 16 charcters</span>
<a name="l00223"></a>00223 <span class="comment">// "HelloHelloHelloH"</span>
<a name="l00224"></a>00224 <span class="comment">//</span>
<a name="l00225"></a>00225 <span class="comment">// Note the truncation. </span>
<a name="l00226"></a>00226 buf.SetLength(16);
<a name="l00227"></a>00227 buf.Repeat(KTextHello);
<a name="l00228"></a>00228
<a name="l00229"></a>00229 <span class="comment">// Look at it.</span>
<a name="l00230"></a>00230 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00231"></a>00231 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00232"></a>00232
<a name="l00233"></a>00233 <span class="comment">// Now set the length to 8 characters</span>
<a name="l00234"></a>00234 <span class="comment">// and do Repeat again.</span>
<a name="l00235"></a>00235 <span class="comment">// Result is the 8 characters</span>
<a name="l00236"></a>00236 <span class="comment">// "HelloHel"</span>
<a name="l00237"></a>00237
<a name="l00238"></a>00238 buf.SetLength(8);
<a name="l00239"></a>00239 buf.Repeat(KTextHello);
<a name="l00240"></a>00240
<a name="l00241"></a>00241 <span class="comment">// Look at it</span>
<a name="l00242"></a>00242 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLen,&buf,buf.Length());
<a name="l00243"></a>00243 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatSizeMax,buf.Size(),buf.MaxLength());
<a name="l00244"></a>00244
<a name="l00245"></a>00245 <span class="comment">// </span>
<a name="l00246"></a>00246 <span class="comment">// Insert() & Delete() * * * * * * * * *</span>
<a name="l00247"></a>00247 <span class="comment">//</span>
<a name="l00248"></a>00248 _LIT(KTitleInsert,<span class="stringliteral">"\n--->Insert() & Delete()"</span>);
<a name="l00249"></a>00249 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleInsert);
<a name="l00250"></a>00250 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l00251"></a>00251 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l00252"></a>00252
<a name="l00253"></a>00253 <span class="comment">// set buf to contain the text "abc" and </span>
<a name="l00254"></a>00254 <span class="comment">// look at it</span>
<a name="l00255"></a>00255 _LIT(KTextAbc,<span class="stringliteral">"abc"</span>);
<a name="l00256"></a>00256 buf = KTextAbc;
<a name="l00257"></a>00257 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00258"></a>00258 &buf,
<a name="l00259"></a>00259 buf.Length(),
<a name="l00260"></a>00260 buf.Size(),
<a name="l00261"></a>00261 buf.MaxLength()
<a name="l00262"></a>00262 );
<a name="l00263"></a>00263
<a name="l00264"></a>00264 <span class="comment">// Insert the descriptor at the beginning</span>
<a name="l00265"></a>00265 <span class="comment">// of buf to give "XYZabc"</span>
<a name="l00266"></a>00266 <span class="comment">//</span>
<a name="l00267"></a>00267
<a name="l00268"></a>00268 buf.Insert(0,KTextXYZ);
<a name="l00269"></a>00269
<a name="l00270"></a>00270 <span class="comment">// Look at it</span>
<a name="l00271"></a>00271 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00272"></a>00272 &buf,
<a name="l00273"></a>00273 buf.Length(),
<a name="l00274"></a>00274 buf.Size(),
<a name="l00275"></a>00275 buf.MaxLength()
<a name="l00276"></a>00276 );
<a name="l00277"></a>00277
<a name="l00278"></a>00278 <span class="comment">// Now insert another descriptor at pos 2</span>
<a name="l00279"></a>00279 <span class="comment">// to give "XijklmnYZabc"</span>
<a name="l00280"></a>00280 <span class="comment">//</span>
<a name="l00281"></a>00281 _LIT(KTextijklmn,<span class="stringliteral">"ijklmn"</span>);
<a name="l00282"></a>00282 buf.Insert(1,KTextijklmn);
<a name="l00283"></a>00283
<a name="l00284"></a>00284 <span class="comment">// Show result</span>
<a name="l00285"></a>00285 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00286"></a>00286 &buf,
<a name="l00287"></a>00287 buf.Length(),
<a name="l00288"></a>00288 buf.Size(),
<a name="l00289"></a>00289 buf.MaxLength()
<a name="l00290"></a>00290 );
<a name="l00291"></a>00291
<a name="l00292"></a>00292
<a name="l00293"></a>00293 <span class="comment">// Insertion point out of range</span>
<a name="l00294"></a>00294 <span class="comment">// (> current length of descriptor)</span>
<a name="l00295"></a>00295 <span class="comment">// </span>
<a name="l00296"></a>00296 <span class="comment">// Remove the "//" marks on the next line</span>
<a name="l00297"></a>00297 <span class="comment">// to see this panic</span>
<a name="l00298"></a>00298 <span class="comment">//_LIT(KTxtqwerty,"qwerty");</span>
<a name="l00299"></a>00299 <span class="comment">//buf.Insert(buf.Length()+1,KTxtqwerty);</span>
<a name="l00300"></a>00300
<a name="l00301"></a>00301
<a name="l00302"></a>00302 <span class="comment">// Resulting length of data</span>
<a name="l00303"></a>00303 <span class="comment">// is > maximum length.</span>
<a name="l00304"></a>00304 <span class="comment">// </span>
<a name="l00305"></a>00305 <span class="comment">// Remove the "//" marks on the next line</span>
<a name="l00306"></a>00306 <span class="comment">// to see this panic</span>
<a name="l00307"></a>00307 <span class="comment">//_LIT(KTxtatoz,"abcdefghijklmnopqrstuvwxyz");</span>
<a name="l00308"></a>00308 <span class="comment">//buf.Insert(12,KTxtatoz);</span>
<a name="l00309"></a>00309
<a name="l00310"></a>00310
<a name="l00311"></a>00311 <span class="comment">// Now delete the 3 data </span>
<a name="l00312"></a>00312 <span class="comment">// items (characters) at the start</span>
<a name="l00313"></a>00313 <span class="comment">// of buf to give "klmnYZabc"</span>
<a name="l00314"></a>00314 buf.Delete(0,3);
<a name="l00315"></a>00315
<a name="l00316"></a>00316 <span class="comment">// Show result</span>
<a name="l00317"></a>00317 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00318"></a>00318 &buf,
<a name="l00319"></a>00319 buf.Length(),
<a name="l00320"></a>00320 buf.Size(),
<a name="l00321"></a>00321 buf.MaxLength()
<a name="l00322"></a>00322 );
<a name="l00323"></a>00323
<a name="l00324"></a>00324 <span class="comment">// Now delete the 4 data items (characters) at</span>
<a name="l00325"></a>00325 <span class="comment">// position 4 to give "klmnc"</span>
<a name="l00326"></a>00326 <span class="comment">//</span>
<a name="l00327"></a>00327 buf.Delete(4,4);
<a name="l00328"></a>00328
<a name="l00329"></a>00329 <span class="comment">// Show result</span>
<a name="l00330"></a>00330 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00331"></a>00331 &buf,
<a name="l00332"></a>00332 buf.Length(),
<a name="l00333"></a>00333 buf.Size(),
<a name="l00334"></a>00334 buf.MaxLength()
<a name="l00335"></a>00335 );
<a name="l00336"></a>00336
<a name="l00337"></a>00337 <span class="comment">// An excessive length for deletion is </span>
<a name="l00338"></a>00338 <span class="comment">// truncated to a sensible value. Deletes </span>
<a name="l00339"></a>00339 <span class="comment">// all the data starting at pos 1 to </span>
<a name="l00340"></a>00340 <span class="comment">// give "k"</span>
<a name="l00341"></a>00341 <span class="comment">// (Note that the length actually</span>
<a name="l00342"></a>00342 <span class="comment">// deleted is 4 NOT 25000).</span>
<a name="l00343"></a>00343
<a name="l00344"></a>00344 buf.Delete(1,25000);
<a name="l00345"></a>00345
<a name="l00346"></a>00346 <span class="comment">// Show result</span>
<a name="l00347"></a>00347 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00348"></a>00348 &buf,
<a name="l00349"></a>00349 buf.Length(),
<a name="l00350"></a>00350 buf.Size(),
<a name="l00351"></a>00351 buf.MaxLength()
<a name="l00352"></a>00352 );
<a name="l00353"></a>00353
<a name="l00354"></a>00354 <span class="comment">// </span>
<a name="l00355"></a>00355 <span class="comment">// TrimLeft() & TrimRight() * * * * * * * * *</span>
<a name="l00356"></a>00356 <span class="comment">//</span>
<a name="l00357"></a>00357 _LIT(KTitleTrimLeft,<span class="stringliteral">"\n--->TrimLeft() & TrimRight()"</span>);
<a name="l00358"></a>00358 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleTrimLeft);
<a name="l00359"></a>00359 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l00360"></a>00360 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l00361"></a>00361
<a name="l00362"></a>00362 <span class="comment">// set buf up and show the detail</span>
<a name="l00363"></a>00363 buf.Fill(<span class="charliteral">' '</span>,18);
<a name="l00364"></a>00364 buf.Replace(3,(&KTextHelloWorld)->Length(),KTextHelloWorld);
<a name="l00365"></a>00365 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00366"></a>00366 &buf,
<a name="l00367"></a>00367 buf.Length(),
<a name="l00368"></a>00368 buf.Size(),
<a name="l00369"></a>00369 buf.MaxLength()
<a name="l00370"></a>00370 );
<a name="l00371"></a>00371
<a name="l00372"></a>00372 <span class="comment">// Remove left hand spaces </span>
<a name="l00373"></a>00373 buf.TrimLeft();
<a name="l00374"></a>00374 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00375"></a>00375 &buf,
<a name="l00376"></a>00376 buf.Length(),
<a name="l00377"></a>00377 buf.Size(),
<a name="l00378"></a>00378 buf.MaxLength()
<a name="l00379"></a>00379 );
<a name="l00380"></a>00380
<a name="l00381"></a>00381 <span class="comment">// Remove right hand spaces </span>
<a name="l00382"></a>00382 buf.TrimRight();
<a name="l00383"></a>00383 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00384"></a>00384 &buf,
<a name="l00385"></a>00385 buf.Length(),
<a name="l00386"></a>00386 buf.Size(),
<a name="l00387"></a>00387 buf.MaxLength()
<a name="l00388"></a>00388 );
<a name="l00389"></a>00389
<a name="l00390"></a>00390 <span class="comment">// Trim() removes both left and right</span>
<a name="l00391"></a>00391 <span class="comment">// hand spaces </span>
<a name="l00392"></a>00392
<a name="l00393"></a>00393
<a name="l00394"></a>00394 <span class="comment">// </span>
<a name="l00395"></a>00395 <span class="comment">// FillZ() & Fill() * * * * * * * * * * </span>
<a name="l00396"></a>00396 <span class="comment">//</span>
<a name="l00397"></a>00397 _LIT(KTitleFill,<span class="stringliteral">"\n--->FillZ() & Fill()"</span>);
<a name="l00398"></a>00398 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleFill);
<a name="l00399"></a>00399 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l00400"></a>00400 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l00401"></a>00401
<a name="l00402"></a>00402 <span class="comment">// Set current length of buf</span>
<a name="l00403"></a>00403 <span class="comment">// Fillz() fills buf up to its current length</span>
<a name="l00404"></a>00404 <span class="comment">// with 0x00.</span>
<a name="l00405"></a>00405 buf.SetLength(8);
<a name="l00406"></a>00406 buf.FillZ();
<a name="l00407"></a>00407
<a name="l00408"></a>00408 <span class="comment">// Show it</span>
<a name="l00409"></a>00409 counter = buf.Length();
<a name="l00410"></a>00410 <span class="keywordflow">for</span> (index = 0; index < counter; index++)
<a name="l00411"></a>00411 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatCommon,buf[index]);
<a name="l00412"></a>00412
<a name="l00413"></a>00413 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatLenSizeMax,
<a name="l00414"></a>00414 buf.Length(),
<a name="l00415"></a>00415 buf.Size(),
<a name="l00416"></a>00416 buf.MaxLength()
<a name="l00417"></a>00417 );
<a name="l00418"></a>00418
<a name="l00419"></a>00419 <span class="comment">// Fills buf up to its current length </span>
<a name="l00420"></a>00420 <span class="comment">// with 'A'</span>
<a name="l00421"></a>00421 buf.Fill(<span class="charliteral">'A'</span>);
<a name="l00422"></a>00422
<a name="l00423"></a>00423 <span class="comment">// show it</span>
<a name="l00424"></a>00424 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00425"></a>00425 &buf,
<a name="l00426"></a>00426 buf.Length(),
<a name="l00427"></a>00427 buf.Size(),
<a name="l00428"></a>00428 buf.MaxLength()
<a name="l00429"></a>00429 );
<a name="l00430"></a>00430
<a name="l00431"></a>00431 <span class="comment">// </span>
<a name="l00432"></a>00432 <span class="comment">// Num(), NumUC(), AppendNum() & AppendNumUC()</span>
<a name="l00433"></a>00433 <span class="comment">//</span>
<a name="l00434"></a>00434 _LIT(KTitleNum,<span class="stringliteral">"\n--->Num(), NumUC(), AppendNum()"</span>);
<a name="l00435"></a>00435 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleNum);
<a name="l00436"></a>00436 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l00437"></a>00437 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l00438"></a>00438
<a name="l00439"></a>00439 <span class="comment">// convert a signed integer to </span>
<a name="l00440"></a>00440 <span class="comment">// decimal characters</span>
<a name="l00441"></a>00441 buf.Num(-176);
<a name="l00442"></a>00442
<a name="l00443"></a>00443 <span class="comment">// show it</span>
<a name="l00444"></a>00444 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00445"></a>00445 &buf,
<a name="l00446"></a>00446 buf.Length(),
<a name="l00447"></a>00447 buf.Size(),
<a name="l00448"></a>00448 buf.MaxLength()
<a name="l00449"></a>00449 );
<a name="l00450"></a>00450
<a name="l00451"></a>00451 <span class="comment">// convert another signed integer</span>
<a name="l00452"></a>00452 buf.Num(12345);
<a name="l00453"></a>00453
<a name="l00454"></a>00454 <span class="comment">// show it</span>
<a name="l00455"></a>00455 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00456"></a>00456 &buf,
<a name="l00457"></a>00457 buf.Length(),
<a name="l00458"></a>00458 buf.Size(),
<a name="l00459"></a>00459 buf.MaxLength()
<a name="l00460"></a>00460 );
<a name="l00461"></a>00461
<a name="l00462"></a>00462 <span class="comment">// convert an unsigned integer</span>
<a name="l00463"></a>00463 TUint nosign = 176;
<a name="l00464"></a>00464
<a name="l00465"></a>00465 <span class="comment">// ... into decimal characters (the default,</span>
<a name="l00466"></a>00466 <span class="comment">// if not explicitly specified)</span>
<a name="l00467"></a>00467 buf.Num(nosign);
<a name="l00468"></a>00468 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00469"></a>00469 &buf,
<a name="l00470"></a>00470 buf.Length(),
<a name="l00471"></a>00471 buf.Size(),
<a name="l00472"></a>00472 buf.MaxLength()
<a name="l00473"></a>00473 );
<a name="l00474"></a>00474
<a name="l00475"></a>00475 <span class="comment">// ... into binary characters</span>
<a name="l00476"></a>00476 buf.Num(nosign,EBinary);
<a name="l00477"></a>00477 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00478"></a>00478 &buf,
<a name="l00479"></a>00479 buf.Length(),
<a name="l00480"></a>00480 buf.Size(),
<a name="l00481"></a>00481 buf.MaxLength()
<a name="l00482"></a>00482 );
<a name="l00483"></a>00483
<a name="l00484"></a>00484 <span class="comment">// ... into octal characters</span>
<a name="l00485"></a>00485 buf.Num(nosign,EOctal);
<a name="l00486"></a>00486 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00487"></a>00487 &buf,
<a name="l00488"></a>00488 buf.Length(),
<a name="l00489"></a>00489 buf.Size(),
<a name="l00490"></a>00490 buf.MaxLength()
<a name="l00491"></a>00491 );
<a name="l00492"></a>00492
<a name="l00493"></a>00493 <span class="comment">// ... into lower case hex characters</span>
<a name="l00494"></a>00494 buf.Num(nosign,EHex);
<a name="l00495"></a>00495 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00496"></a>00496 &buf,
<a name="l00497"></a>00497 buf.Length(),
<a name="l00498"></a>00498 buf.Size(),
<a name="l00499"></a>00499 buf.MaxLength()
<a name="l00500"></a>00500 );
<a name="l00501"></a>00501
<a name="l00502"></a>00502 <span class="comment">// ... into upper case hex characters</span>
<a name="l00503"></a>00503 buf.NumUC(nosign,EHex);
<a name="l00504"></a>00504 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00505"></a>00505 &buf,
<a name="l00506"></a>00506 buf.Length(),
<a name="l00507"></a>00507 buf.Size(),
<a name="l00508"></a>00508 buf.MaxLength()
<a name="l00509"></a>00509 );
<a name="l00510"></a>00510
<a name="l00511"></a>00511 <span class="comment">// Append functions the same, except </span>
<a name="l00512"></a>00512 <span class="comment">// they append the converted data.</span>
<a name="l00513"></a>00513 <span class="comment">// Put "xyz" into the descriptor, convert</span>
<a name="l00514"></a>00514 <span class="comment">// and concatenate the variations.</span>
<a name="l00515"></a>00515
<a name="l00516"></a>00516 _LIT(KTextxyz,<span class="stringliteral">"xyz"</span>);
<a name="l00517"></a>00517 buf = KTextxyz;
<a name="l00518"></a>00518
<a name="l00519"></a>00519 buf.AppendNum(nosign);
<a name="l00520"></a>00520 buf.AppendNum(nosign,EBinary);
<a name="l00521"></a>00521 buf.AppendNum(nosign,EOctal);
<a name="l00522"></a>00522 buf.AppendNum(nosign,EHex);
<a name="l00523"></a>00523 buf.AppendNumUC(nosign,EHex);
<a name="l00524"></a>00524 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00525"></a>00525 &buf,
<a name="l00526"></a>00526 buf.Length(),
<a name="l00527"></a>00527 buf.Size(),
<a name="l00528"></a>00528 buf.MaxLength()
<a name="l00529"></a>00529 );
<a name="l00530"></a>00530
<a name="l00531"></a>00531 <span class="comment">// </span>
<a name="l00532"></a>00532 <span class="comment">// Justify() & AppendJustify()* * * </span>
<a name="l00533"></a>00533 <span class="comment">//</span>
<a name="l00534"></a>00534 _LIT(KTitleJustify,<span class="stringliteral">"\n--->Justify() & AppendJustify()"</span>);
<a name="l00535"></a>00535 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleJustify);
<a name="l00536"></a>00536 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l00537"></a>00537
<a name="l00538"></a>00538 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l00539"></a>00539
<a name="l00540"></a>00540 <span class="comment">// source descriptor for this example has</span>
<a name="l00541"></a>00541 <span class="comment">// length 12. </span>
<a name="l00542"></a>00542 TBufC<40> src(KTextHelloWorld);
<a name="l00543"></a>00543
<a name="l00544"></a>00544 <span class="comment">// target field in buf has width 16 (NB this</span>
<a name="l00545"></a>00545 <span class="comment">// is greater than the length of the descriptor </span>
<a name="l00546"></a>00546 <span class="comment">// src).</span>
<a name="l00547"></a>00547 <span class="comment">// src is copied into target field, aligned left </span>
<a name="l00548"></a>00548 <span class="comment">// and padded with '@' characters.</span>
<a name="l00549"></a>00549 <span class="comment">//</span>
<a name="l00550"></a>00550 <span class="comment">// length of buf becomes the same as the </span>
<a name="l00551"></a>00551 <span class="comment">// specified width, i.e 16 </span>
<a name="l00552"></a>00552 buf.Justify(src,16,ELeft,<span class="charliteral">'@'</span>);
<a name="l00553"></a>00553 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00554"></a>00554 &buf,
<a name="l00555"></a>00555 buf.Length(),
<a name="l00556"></a>00556 buf.Size(),
<a name="l00557"></a>00557 buf.MaxLength()
<a name="l00558"></a>00558 );
<a name="l00559"></a>00559
<a name="l00560"></a>00560 <span class="comment">// target field in buf has width 16 (NB this</span>
<a name="l00561"></a>00561 <span class="comment">// is greater than the length of the descriptor</span>
<a name="l00562"></a>00562 <span class="comment">// src).</span>
<a name="l00563"></a>00563 <span class="comment">// src is copied into target field, aligned centre </span>
<a name="l00564"></a>00564 <span class="comment">// and padded with '@' characters</span>
<a name="l00565"></a>00565 <span class="comment">//</span>
<a name="l00566"></a>00566 <span class="comment">// length of buf becomes the same as the</span>
<a name="l00567"></a>00567 <span class="comment">// specified width, i.e 16 </span>
<a name="l00568"></a>00568 buf.Justify(src,16,ECenter,<span class="charliteral">'@'</span>);
<a name="l00569"></a>00569 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00570"></a>00570 &buf,
<a name="l00571"></a>00571 buf.Length(),
<a name="l00572"></a>00572 buf.Size(),
<a name="l00573"></a>00573 buf.MaxLength()
<a name="l00574"></a>00574 );
<a name="l00575"></a>00575
<a name="l00576"></a>00576 <span class="comment">// target field in buf has width 10 (NB this</span>
<a name="l00577"></a>00577 <span class="comment">// is smaller than the length of the descriptor</span>
<a name="l00578"></a>00578 <span class="comment">// src).</span>
<a name="l00579"></a>00579 <span class="comment">// src is copied into target field but truncated</span>
<a name="l00580"></a>00580 <span class="comment">// to 10 characters and, therefore, alignment and </span>
<a name="l00581"></a>00581 <span class="comment">// padding information not used.</span>
<a name="l00582"></a>00582 <span class="comment">//</span>
<a name="l00583"></a>00583 <span class="comment">// length of buf becomes the same as the </span>
<a name="l00584"></a>00584 <span class="comment">// width, i.e 10 </span>
<a name="l00585"></a>00585 buf.Justify(src,10,ECenter,<span class="charliteral">'@'</span>);
<a name="l00586"></a>00586 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00587"></a>00587 &buf,
<a name="l00588"></a>00588 buf.Length(),
<a name="l00589"></a>00589 buf.Size(),
<a name="l00590"></a>00590 buf.MaxLength()
<a name="l00591"></a>00591 );
<a name="l00592"></a>00592
<a name="l00593"></a>00593 <span class="comment">// target field in buf is set to the length of</span>
<a name="l00594"></a>00594 <span class="comment">// the descriptor src (whatever it currently is)</span>
<a name="l00595"></a>00595 <span class="comment">//</span>
<a name="l00596"></a>00596 <span class="comment">// src copied into target field. No padding and</span>
<a name="l00597"></a>00597 <span class="comment">// no truncatiuon needed and so the</span>
<a name="l00598"></a>00598 <span class="comment">// alignment and padding information is not used.</span>
<a name="l00599"></a>00599 <span class="comment">//</span>
<a name="l00600"></a>00600 <span class="comment">// length of buf becomes the same as the length</span>
<a name="l00601"></a>00601 <span class="comment">// of src i.e 12 </span>
<a name="l00602"></a>00602 buf.Justify(src,KDefaultJustifyWidth,ECenter,<span class="charliteral">'@'</span>);
<a name="l00603"></a>00603 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00604"></a>00604 &buf,
<a name="l00605"></a>00605 buf.Length(),
<a name="l00606"></a>00606 buf.Size(),
<a name="l00607"></a>00607 buf.MaxLength()
<a name="l00608"></a>00608 );
<a name="l00609"></a>00609
<a name="l00610"></a>00610
<a name="l00611"></a>00611
<a name="l00612"></a>00612 <span class="comment">// implied width > maximum length of buf.</span>
<a name="l00613"></a>00613 <span class="comment">// </span>
<a name="l00614"></a>00614 <span class="comment">// Remove the "//" marks on the next two lines</span>
<a name="l00615"></a>00615 <span class="comment">// to see this panic</span>
<a name="l00616"></a>00616 <span class="comment">//_LIT(KTxtPanicCausingText,"Panic causing text because length > 32");</span>
<a name="l00617"></a>00617 <span class="comment">//src = KTxtPanicCausingText;</span>
<a name="l00618"></a>00618 <span class="comment">//buf.Justify(src,KDefaultJustifyWidth,ECenter,'@' );</span>
<a name="l00619"></a>00619
<a name="l00620"></a>00620
<a name="l00621"></a>00621
<a name="l00622"></a>00622 <span class="comment">// explicit width > maximum length of buf</span>
<a name="l00623"></a>00623 <span class="comment">// </span>
<a name="l00624"></a>00624 <span class="comment">// Remove the "//" marks on the next line</span>
<a name="l00625"></a>00625 <span class="comment">// to see this panic</span>
<a name="l00626"></a>00626 <span class="comment">//buf.Justify(src,33,ECenter,'@');</span>
<a name="l00627"></a>00627
<a name="l00628"></a>00628
<a name="l00629"></a>00629 <span class="comment">// AppendJustify() is similar but target </span>
<a name="l00630"></a>00630 <span class="comment">// field appended to descriptor.</span>
<a name="l00631"></a>00631 <span class="comment">//</span>
<a name="l00632"></a>00632 <span class="comment">// Target field in buf has width 16 </span>
<a name="l00633"></a>00633 <span class="comment">// (NB greater than length of descriptor </span>
<a name="l00634"></a>00634 <span class="comment">// src) and is appended to existing content</span>
<a name="l00635"></a>00635 <span class="comment">// of buf.</span>
<a name="l00636"></a>00636 <span class="comment">// src copied into target field, </span>
<a name="l00637"></a>00637 <span class="comment">// aligned left and padded with '@' </span>
<a name="l00638"></a>00638 <span class="comment">// characters</span>
<a name="l00639"></a>00639 <span class="comment">//</span>
<a name="l00640"></a>00640 <span class="comment">// Resulting length of buf is the length</span>
<a name="l00641"></a>00641 <span class="comment">// of "ABCD" plus the width of the target</span>
<a name="l00642"></a>00642 <span class="comment">// field (16) giving a value of 20.</span>
<a name="l00643"></a>00643 _LIT(KTextABCD,<span class="stringliteral">"ABCD"</span>);
<a name="l00644"></a>00644 buf = KTextABCD;
<a name="l00645"></a>00645 buf.AppendJustify(src,16,ELeft,<span class="charliteral">'@'</span>);
<a name="l00646"></a>00646 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00647"></a>00647 &buf,
<a name="l00648"></a>00648 buf.Length(),
<a name="l00649"></a>00649 buf.Size(),
<a name="l00650"></a>00650 buf.MaxLength()
<a name="l00651"></a>00651 );
<a name="l00652"></a>00652
<a name="l00653"></a>00653 <span class="comment">// </span>
<a name="l00654"></a>00654 <span class="comment">// Format() & AppendFormat() * * * </span>
<a name="l00655"></a>00655 <span class="comment">//</span>
<a name="l00656"></a>00656 _LIT(KTitleFormatAndAppendFormat,<span class="stringliteral">"\n--->Format() & AppendFormat()"</span>);
<a name="l00657"></a>00657 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleFormatAndAppendFormat);
<a name="l00658"></a>00658 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l00659"></a>00659 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l00660"></a>00660
<a name="l00661"></a>00661 <span class="comment">// use tgt as a target descriptor to show </span>
<a name="l00662"></a>00662 <span class="comment">// the results of format()</span>
<a name="l00663"></a>00663 TBuf<128> tgt;
<a name="l00664"></a>00664
<a name="l00665"></a>00665 <span class="comment">// The basic %<type> format.</span>
<a name="l00666"></a>00666 <span class="comment">// Interprets the arguments as signed/unsigned</span>
<a name="l00667"></a>00667 <span class="comment">// integers and generates the appropriate</span>
<a name="l00668"></a>00668 <span class="comment">// character representations. The characters only</span>
<a name="l00669"></a>00669 <span class="comment">// occupy the space needed to represent them.</span>
<a name="l00670"></a>00670 <span class="comment">//</span>
<a name="l00671"></a>00671 <span class="comment">// Generates:"1000001 A 65 101 65 41"</span>
<a name="l00672"></a>00672 <span class="comment">//</span>
<a name="l00673"></a>00673 <span class="comment">// format string is:</span>
<a name="l00674"></a>00674 <span class="comment">// "%b %c %d %o %u %x"</span>
<a name="l00675"></a>00675
<a name="l00676"></a>00676 _LIT(KFormat1,<span class="stringliteral">"%b %c %d %o %u %x"</span>);
<a name="l00677"></a>00677 tgt.Format(KFormat1,65,65,65,65,65,65);
<a name="l00678"></a>00678 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00679"></a>00679 &tgt,
<a name="l00680"></a>00680 tgt.Length(),
<a name="l00681"></a>00681 tgt.Size(),
<a name="l00682"></a>00682 tgt.MaxLength()
<a name="l00683"></a>00683 );
<a name="l00684"></a>00684
<a name="l00685"></a>00685 <span class="comment">// Interprets the argument as an unsigned</span>
<a name="l00686"></a>00686 <span class="comment">// integer; the generated (hex) characters are</span>
<a name="l00687"></a>00687 <span class="comment">// right aligned and padded to the left</span>
<a name="l00688"></a>00688 <span class="comment">// with '0' to make a total of 4 characters.</span>
<a name="l00689"></a>00689 <span class="comment">//</span>
<a name="l00690"></a>00690 <span class="comment">// Generates:"0041"</span>
<a name="l00691"></a>00691 <span class="comment">//</span>
<a name="l00692"></a>00692 <span class="comment">// format string is:</span>
<a name="l00693"></a>00693 <span class="comment">// "%04x"</span>
<a name="l00694"></a>00694 _LIT(KFormat2,<span class="stringliteral">"%04x"</span>);
<a name="l00695"></a>00695 tgt.Format(KFormat2,65);
<a name="l00696"></a>00696 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00697"></a>00697 &tgt,
<a name="l00698"></a>00698 tgt.Length(),
<a name="l00699"></a>00699 tgt.Size(),
<a name="l00700"></a>00700 tgt.MaxLength()
<a name="l00701"></a>00701 );
<a name="l00702"></a>00702
<a name="l00703"></a>00703 <span class="comment">// Interprets the argument as an unsigned</span>
<a name="l00704"></a>00704 <span class="comment">// integer;the generated (hex) characters are</span>
<a name="l00705"></a>00705 <span class="comment">// right aligned and padded to the left with </span>
<a name="l00706"></a>00706 <span class="comment">// blanks to make a total of 4 characters.</span>
<a name="l00707"></a>00707 <span class="comment">//</span>
<a name="l00708"></a>00708 <span class="comment">// Generates:" 41"</span>
<a name="l00709"></a>00709 <span class="comment">//</span>
<a name="l00710"></a>00710 <span class="comment">// format string is:</span>
<a name="l00711"></a>00711 <span class="comment">// "%4x"</span>
<a name="l00712"></a>00712 tgt.Format(KFormatfourex,65);
<a name="l00713"></a>00713 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00714"></a>00714 &tgt,
<a name="l00715"></a>00715 tgt.Length(),
<a name="l00716"></a>00716 tgt.Size(),
<a name="l00717"></a>00717 tgt.MaxLength()
<a name="l00718"></a>00718 );
<a name="l00719"></a>00719
<a name="l00720"></a>00720 <span class="comment">// Interprets the argument as an unsigned</span>
<a name="l00721"></a>00721 <span class="comment">// integer; the generated (hex) characters are</span>
<a name="l00722"></a>00722 <span class="comment">// right aligned and padded to the left with </span>
<a name="l00723"></a>00723 <span class="comment">// blanks to make a total of 4 characters.</span>
<a name="l00724"></a>00724 <span class="comment">//</span>
<a name="l00725"></a>00725 <span class="comment">// Generates:"1fff" </span>
<a name="l00726"></a>00726 <span class="comment">//</span>
<a name="l00727"></a>00727 <span class="comment">// NB the correct hex value is "1ffff"</span>
<a name="l00728"></a>00728 <span class="comment">// but width specified as 4 resulting </span>
<a name="l00729"></a>00729 <span class="comment">// in TRUNCATION.</span>
<a name="l00730"></a>00730 <span class="comment">// </span>
<a name="l00731"></a>00731 <span class="comment">//</span>
<a name="l00732"></a>00732 <span class="comment">// format string is:</span>
<a name="l00733"></a>00733 <span class="comment">// "%4x"</span>
<a name="l00734"></a>00734 tgt.Format(KFormatfourex,131071);
<a name="l00735"></a>00735 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00736"></a>00736 &tgt,
<a name="l00737"></a>00737 tgt.Length(),
<a name="l00738"></a>00738 tgt.Size(),
<a name="l00739"></a>00739 tgt.MaxLength()
<a name="l00740"></a>00740 );
<a name="l00741"></a>00741
<a name="l00742"></a>00742 <span class="comment">// The '*' means that the width of the output</span>
<a name="l00743"></a>00743 <span class="comment">// is taken from the 1st argument in the list; </span>
<a name="l00744"></a>00744 <span class="comment">// Interprets the 2nd argument as an unsigned</span>
<a name="l00745"></a>00745 <span class="comment">// integer.</span>
<a name="l00746"></a>00746 <span class="comment">// The generated (hex) characters are right </span>
<a name="l00747"></a>00747 <span class="comment">// aligned and padded to the left with blanks</span>
<a name="l00748"></a>00748 <span class="comment">// to make a total of 4 characters.</span>
<a name="l00749"></a>00749 <span class="comment">//</span>
<a name="l00750"></a>00750 <span class="comment">// Generates:" 41"</span>
<a name="l00751"></a>00751 <span class="comment">//</span>
<a name="l00752"></a>00752 <span class="comment">// format string is:</span>
<a name="l00753"></a>00753 <span class="comment">// "%*x"</span>
<a name="l00754"></a>00754 _LIT(KFormat4,<span class="stringliteral">"%*x"</span>);
<a name="l00755"></a>00755 tgt.Format(KFormat4,4,65);
<a name="l00756"></a>00756 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00757"></a>00757 &tgt,
<a name="l00758"></a>00758 tgt.Length(),
<a name="l00759"></a>00759 tgt.Size(),
<a name="l00760"></a>00760 tgt.MaxLength()
<a name="l00761"></a>00761 );
<a name="l00762"></a>00762
<a name="l00763"></a>00763 <span class="comment">// Interprets the 1st argument as a signed</span>
<a name="l00764"></a>00764 <span class="comment">// integer. </span>
<a name="l00765"></a>00765 <span class="comment">//</span>
<a name="l00766"></a>00766 <span class="comment">// The generated (decimal) characters are </span>
<a name="l00767"></a>00767 <span class="comment">// right aligned and padded to the left </span>
<a name="l00768"></a>00768 <span class="comment">// with '$' to make a total of 4 characters.</span>
<a name="l00769"></a>00769 <span class="comment">//</span>
<a name="l00770"></a>00770 <span class="comment">// These are then followed by the</span>
<a name="l00771"></a>00771 <span class="comment">// 4 characters ".00 "</span>
<a name="l00772"></a>00772 <span class="comment">// </span>
<a name="l00773"></a>00773 <span class="comment">// Interprets the 2nd argument as a descriptor.</span>
<a name="l00774"></a>00774 <span class="comment">// The characters within the descriptor are</span>
<a name="l00775"></a>00775 <span class="comment">// appended to those already generated.</span>
<a name="l00776"></a>00776 <span class="comment">//</span>
<a name="l00777"></a>00777 <span class="comment">// Generates:"$$65.00 over"</span>
<a name="l00778"></a>00778 <span class="comment">//</span>
<a name="l00779"></a>00779 <span class="comment">// Format string is:</span>
<a name="l00780"></a>00780 <span class="comment">// "%+$4d.00 %S"</span>
<a name="l00781"></a>00781 <span class="comment">//</span>
<a name="l00782"></a>00782
<a name="l00783"></a>00783 _LIT(KTextover,<span class="stringliteral">"over"</span>);
<a name="l00784"></a>00784 _LIT(KFormat5,<span class="stringliteral">"%+$4d.00 %S"</span>);
<a name="l00785"></a>00785 tgt.Format(KFormat5,65,&KTextover);
<a name="l00786"></a>00786 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00787"></a>00787 &tgt,
<a name="l00788"></a>00788 tgt.Length(),
<a name="l00789"></a>00789 tgt.Size(),
<a name="l00790"></a>00790 tgt.MaxLength()
<a name="l00791"></a>00791 );
<a name="l00792"></a>00792
<a name="l00793"></a>00793
<a name="l00794"></a>00794 <span class="comment">// The * means that the width of the </span>
<a name="l00795"></a>00795 <span class="comment">// output is taken from the 1st argument </span>
<a name="l00796"></a>00796 <span class="comment">// in the list.</span>
<a name="l00797"></a>00797 <span class="comment">//</span>
<a name="l00798"></a>00798 <span class="comment">// Interprets the 2nd argument as a descriptor.</span>
<a name="l00799"></a>00799 <span class="comment">// The characters copied from it are right </span>
<a name="l00800"></a>00800 <span class="comment">// aligned and padded on the left with</span>
<a name="l00801"></a>00801 <span class="comment">// '0' characters</span>
<a name="l00802"></a>00802 <span class="comment">//</span>
<a name="l00803"></a>00803 <span class="comment">// Generates:"000000fred"</span>
<a name="l00804"></a>00804 <span class="comment">//</span>
<a name="l00805"></a>00805 <span class="comment">// Format string is:</span>
<a name="l00806"></a>00806 <span class="comment">// "%+0*S"</span>
<a name="l00807"></a>00807 <span class="comment">//</span>
<a name="l00808"></a>00808
<a name="l00809"></a>00809 _LIT(KTextfred,<span class="stringliteral">"fred"</span>);
<a name="l00810"></a>00810 _LIT(KFormat6,<span class="stringliteral">"%+0*S"</span>);
<a name="l00811"></a>00811 tgt.Format(KFormat6,10,&KTextfred);
<a name="l00812"></a>00812 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00813"></a>00813 &tgt,
<a name="l00814"></a>00814 tgt.Length(),
<a name="l00815"></a>00815 tgt.Size(),
<a name="l00816"></a>00816 tgt.MaxLength()
<a name="l00817"></a>00817 );
<a name="l00818"></a>00818
<a name="l00819"></a>00819
<a name="l00820"></a>00820 <span class="comment">// The * means that the fill character is </span>
<a name="l00821"></a>00821 <span class="comment">// taken from the 1st argument in the list.</span>
<a name="l00822"></a>00822 <span class="comment">//</span>
<a name="l00823"></a>00823 <span class="comment">// Interprets the 2nd argument as an unsigned</span>
<a name="l00824"></a>00824 <span class="comment">// integer.</span>
<a name="l00825"></a>00825 <span class="comment">// The generated characters are centrally </span>
<a name="l00826"></a>00826 <span class="comment">// aligned and padded on the left and right</span>
<a name="l00827"></a>00827 <span class="comment">// with '*' to make 6 characters.</span>
<a name="l00828"></a>00828 <span class="comment">//</span>
<a name="l00829"></a>00829 <span class="comment">// Generates:"**41**"</span>
<a name="l00830"></a>00830 <span class="comment">//</span>
<a name="l00831"></a>00831 <span class="comment">// Format string is:</span>
<a name="l00832"></a>00832 <span class="comment">// "%=*6x"</span>
<a name="l00833"></a>00833 <span class="comment">//</span>
<a name="l00834"></a>00834
<a name="l00835"></a>00835 _LIT(KFormat7,<span class="stringliteral">"%=*6x"</span>);
<a name="l00836"></a>00836 tgt.Format(KFormat7,<span class="charliteral">'*'</span>,65);
<a name="l00837"></a>00837 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00838"></a>00838 &tgt,
<a name="l00839"></a>00839 tgt.Length(),
<a name="l00840"></a>00840 tgt.Size(),
<a name="l00841"></a>00841 tgt.MaxLength()
<a name="l00842"></a>00842 );
<a name="l00843"></a>00843
<a name="l00844"></a>00844 <span class="comment">// The 1st '*' means that the fill character </span>
<a name="l00845"></a>00845 <span class="comment">// is taken from the 1st argument in the list.</span>
<a name="l00846"></a>00846 <span class="comment">//</span>
<a name="l00847"></a>00847 <span class="comment">// The 2nd '*' means that the width is taken</span>
<a name="l00848"></a>00848 <span class="comment">// from the 2nd argument in the list</span>
<a name="l00849"></a>00849 <span class="comment">//</span>
<a name="l00850"></a>00850 <span class="comment">// Interprets the 3rd argument as a signed</span>
<a name="l00851"></a>00851 <span class="comment">// integer.</span>
<a name="l00852"></a>00852 <span class="comment">// The generated characters are right aligned</span>
<a name="l00853"></a>00853 <span class="comment">// and padded on the left with '.' to make</span>
<a name="l00854"></a>00854 <span class="comment">// 10 characters.</span>
<a name="l00855"></a>00855 <span class="comment">//</span>
<a name="l00856"></a>00856 <span class="comment">// Generates:".......-65"</span>
<a name="l00857"></a>00857 <span class="comment">//</span>
<a name="l00858"></a>00858 <span class="comment">// Format string is:</span>
<a name="l00859"></a>00859 <span class="comment">// "%+**d"</span>
<a name="l00860"></a>00860 <span class="comment">//</span>
<a name="l00861"></a>00861
<a name="l00862"></a>00862 _LIT(KFormat8,<span class="stringliteral">"%+**d"</span>);
<a name="l00863"></a>00863 tgt.Format(KFormat8,<span class="charliteral">'.'</span>,10,(-65));
<a name="l00864"></a>00864 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00865"></a>00865 &tgt,
<a name="l00866"></a>00866 tgt.Length(),
<a name="l00867"></a>00867 tgt.Size(),
<a name="l00868"></a>00868 tgt.MaxLength()
<a name="l00869"></a>00869 );
<a name="l00870"></a>00870
<a name="l00871"></a>00871 <span class="comment">// Same as the previous example but the </span>
<a name="l00872"></a>00872 <span class="comment">// characters are left aligned and padded to</span>
<a name="l00873"></a>00873 <span class="comment">// the right with '.' characters.</span>
<a name="l00874"></a>00874 <span class="comment">//</span>
<a name="l00875"></a>00875 <span class="comment">// Generates:"-65......." </span>
<a name="l00876"></a>00876 <span class="comment">//</span>
<a name="l00877"></a>00877 <span class="comment">// Format string is:</span>
<a name="l00878"></a>00878 <span class="comment">// "%-**d"</span>
<a name="l00879"></a>00879 <span class="comment">//</span>
<a name="l00880"></a>00880
<a name="l00881"></a>00881 _LIT(KFormat9,<span class="stringliteral">"%-**d"</span>);
<a name="l00882"></a>00882 tgt.Format(KFormat9,<span class="charliteral">'.'</span>,10,(-65));
<a name="l00883"></a>00883 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00884"></a>00884 &tgt,
<a name="l00885"></a>00885 tgt.Length(),
<a name="l00886"></a>00886 tgt.Size(),
<a name="l00887"></a>00887 tgt.MaxLength()
<a name="l00888"></a>00888 );
<a name="l00889"></a>00889
<a name="l00890"></a>00890 <span class="comment">// Generates 6 fill characters 'A'.</span>
<a name="l00891"></a>00891 <span class="comment">// Makes no use of the argument list.</span>
<a name="l00892"></a>00892 <span class="comment">//</span>
<a name="l00893"></a>00893 <span class="comment">// Generates: "AAAAAA" </span>
<a name="l00894"></a>00894 <span class="comment">//</span>
<a name="l00895"></a>00895 <span class="comment">// Format string is:</span>
<a name="l00896"></a>00896 <span class="comment">// "%-A6p"</span>
<a name="l00897"></a>00897 <span class="comment">//</span>
<a name="l00898"></a>00898
<a name="l00899"></a>00899 _LIT(KFormat10,<span class="stringliteral">"%-A6p"</span>);
<a name="l00900"></a>00900 tgt.Format(KFormat10,65);
<a name="l00901"></a>00901 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00902"></a>00902 &tgt,
<a name="l00903"></a>00903 tgt.Length(),
<a name="l00904"></a>00904 tgt.Size(),
<a name="l00905"></a>00905 tgt.MaxLength()
<a name="l00906"></a>00906 );
<a name="l00907"></a>00907
<a name="l00908"></a>00908 <span class="comment">// Interpret the argument as a TInt64 type. </span>
<a name="l00909"></a>00909 _LIT(KFormat10a,<span class="stringliteral">"%Li"</span>);
<a name="l00910"></a>00910
<a name="l00911"></a>00911 TInt64 var(65);
<a name="l00912"></a>00912 tgt.Format(KFormat10a,var);
<a name="l00913"></a>00913
<a name="l00914"></a>00914 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatBufLenSizeMax,
<a name="l00915"></a>00915 &tgt,
<a name="l00916"></a>00916 tgt.Length(),
<a name="l00917"></a>00917 tgt.Size(),
<a name="l00918"></a>00918 tgt.MaxLength()
<a name="l00919"></a>00919 );
<a name="l00920"></a>00920
<a name="l00921"></a>00921
<a name="l00922"></a>00922
<a name="l00923"></a>00923
<a name="l00924"></a>00924 <span class="comment">// Interpret the argument as an unsigned integer</span>
<a name="l00925"></a>00925 <span class="comment">// and convert to a two byte numeric </span>
<a name="l00926"></a>00926 <span class="comment">// representation (most significant byte first)</span>
<a name="l00927"></a>00927 <span class="comment">//</span>
<a name="l00928"></a>00928 <span class="comment">// So 4660 = 0x1234 => 1st byte contains 0x12</span>
<a name="l00929"></a>00929 <span class="comment">// 2nd byte contains 0x34 </span>
<a name="l00930"></a>00930 <span class="comment">//</span>
<a name="l00931"></a>00931 <span class="comment">// NB This is same for both ASCII & UNICODE build</span>
<a name="l00932"></a>00932 <span class="comment">//</span>
<a name="l00933"></a>00933 <span class="comment">// Format string is:</span>
<a name="l00934"></a>00934 <span class="comment">// "%m"</span>
<a name="l00935"></a>00935 <span class="comment">//</span>
<a name="l00936"></a>00936
<a name="l00937"></a>00937 _LIT(KFormat11,<span class="stringliteral">"%m"</span>);
<a name="l00938"></a>00938 tgt.Format(KFormat11,4660);
<a name="l00939"></a>00939
<a name="l00940"></a>00940 counter = tgt.Length();
<a name="l00941"></a>00941 <span class="keywordflow">for</span> (index = 0; index < counter; index++)
<a name="l00942"></a>00942 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatCommon,tgt[index]);
<a name="l00943"></a>00943
<a name="l00944"></a>00944 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatLenSizeMax,
<a name="l00945"></a>00945 tgt.Length(),
<a name="l00946"></a>00946 tgt.Size(),
<a name="l00947"></a>00947 tgt.MaxLength()
<a name="l00948"></a>00948 );
<a name="l00949"></a>00949
<a name="l00950"></a>00950
<a name="l00951"></a>00951
<a name="l00952"></a>00952
<a name="l00953"></a>00953
<a name="l00954"></a>00954 <span class="comment">// Interpret the argument as an unsigned integer</span>
<a name="l00955"></a>00955 <span class="comment">// and convert to a four byte numeric </span>
<a name="l00956"></a>00956 <span class="comment">// representation (most significant byte first)</span>
<a name="l00957"></a>00957 <span class="comment">//</span>
<a name="l00958"></a>00958 <span class="comment">// So 4660 = 0x1234 => 1st byte contains 0x00</span>
<a name="l00959"></a>00959 <span class="comment">// 2nd byte contains 0x00 </span>
<a name="l00960"></a>00960 <span class="comment">// 3rd byte contains 0x12</span>
<a name="l00961"></a>00961 <span class="comment">// 4th byte contains 0x34</span>
<a name="l00962"></a>00962 <span class="comment">// NB This is same for both ASCII & UNICODE build </span>
<a name="l00963"></a>00963 <span class="comment">//</span>
<a name="l00964"></a>00964 <span class="comment">// Format string is:</span>
<a name="l00965"></a>00965 <span class="comment">// "%M"</span>
<a name="l00966"></a>00966 <span class="comment">//</span>
<a name="l00967"></a>00967
<a name="l00968"></a>00968 _LIT(KFormat12,<span class="stringliteral">"%M"</span>);
<a name="l00969"></a>00969 tgt.Format(KFormat12,4660);
<a name="l00970"></a>00970
<a name="l00971"></a>00971 counter = tgt.Length();
<a name="l00972"></a>00972 <span class="keywordflow">for</span> (index = 0; index < counter; index++)
<a name="l00973"></a>00973 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatCommon,tgt[index]);
<a name="l00974"></a>00974
<a name="l00975"></a>00975 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatLenSizeMax,
<a name="l00976"></a>00976 tgt.Length(),
<a name="l00977"></a>00977 tgt.Size(),
<a name="l00978"></a>00978 tgt.MaxLength()
<a name="l00979"></a>00979 );
<a name="l00980"></a>00980
<a name="l00981"></a>00981 <span class="comment">// Interpret the argument as an unsigned integer</span>
<a name="l00982"></a>00982 <span class="comment">// and convert to a two byte numeric </span>
<a name="l00983"></a>00983 <span class="comment">// representation (least significant byte first)</span>
<a name="l00984"></a>00984 <span class="comment">//</span>
<a name="l00985"></a>00985 <span class="comment">// So 4660 = 0x1234 => 1st byte contains 0x34</span>
<a name="l00986"></a>00986 <span class="comment">// 2nd byte contains 0x12 </span>
<a name="l00987"></a>00987 <span class="comment">//</span>
<a name="l00988"></a>00988 <span class="comment">// NB This is same for both ASCII & UNICODE build</span>
<a name="l00989"></a>00989 <span class="comment">//</span>
<a name="l00990"></a>00990 <span class="comment">// Format string is:</span>
<a name="l00991"></a>00991 <span class="comment">// "%w"</span>
<a name="l00992"></a>00992 <span class="comment">//</span>
<a name="l00993"></a>00993
<a name="l00994"></a>00994 _LIT(KFormat13,<span class="stringliteral">"%w"</span>);
<a name="l00995"></a>00995 tgt.Format(KFormat13,4660);
<a name="l00996"></a>00996
<a name="l00997"></a>00997 counter = tgt.Length();
<a name="l00998"></a>00998 <span class="keywordflow">for</span> (index = 0; index < counter; index++)
<a name="l00999"></a>00999 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatCommon,tgt[index]);
<a name="l01000"></a>01000
<a name="l01001"></a>01001 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatLenSizeMax,
<a name="l01002"></a>01002 tgt.Length(),
<a name="l01003"></a>01003 tgt.Size(),
<a name="l01004"></a>01004 tgt.MaxLength()
<a name="l01005"></a>01005 );
<a name="l01006"></a>01006
<a name="l01007"></a>01007 <span class="comment">// Interpret the argument as an unsigned integer</span>
<a name="l01008"></a>01008 <span class="comment">// and convert to a four byte numeric </span>
<a name="l01009"></a>01009 <span class="comment">// representation (least significant byte first)</span>
<a name="l01010"></a>01010 <span class="comment">//</span>
<a name="l01011"></a>01011 <span class="comment">// So 4660 = 0x1234 => 1st byte contains 0x34</span>
<a name="l01012"></a>01012 <span class="comment">// 2nd byte contains 0x12 </span>
<a name="l01013"></a>01013 <span class="comment">// 3rd byte contains 0x00</span>
<a name="l01014"></a>01014 <span class="comment">// 4th byte contains 0x00</span>
<a name="l01015"></a>01015 <span class="comment">// NB This is same for both ASCII & UNICODE build </span>
<a name="l01016"></a>01016 <span class="comment">//</span>
<a name="l01017"></a>01017 <span class="comment">// Format string is:</span>
<a name="l01018"></a>01018 <span class="comment">// "%W"</span>
<a name="l01019"></a>01019 <span class="comment">//</span>
<a name="l01020"></a>01020
<a name="l01021"></a>01021 _LIT(KFormat14,<span class="stringliteral">"%W"</span>);
<a name="l01022"></a>01022 tgt.Format(KFormat14,4660);
<a name="l01023"></a>01023
<a name="l01024"></a>01024 counter = tgt.Length();
<a name="l01025"></a>01025 <span class="keywordflow">for</span> (index = 0; index < counter; index++)
<a name="l01026"></a>01026 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatCommon,tgt[index]);
<a name="l01027"></a>01027
<a name="l01028"></a>01028 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KFormatLenSizeMax,
<a name="l01029"></a>01029 tgt.Length(),
<a name="l01030"></a>01030 tgt.Size(),
<a name="l01031"></a>01031 tgt.MaxLength()
<a name="l01032"></a>01032 );
<a name="l01033"></a>01033
<a name="l01034"></a>01034 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l01035"></a>01035 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l01036"></a>01036
<a name="l01037"></a>01037
<a name="l01038"></a>01038 <span class="comment">// </span>
<a name="l01039"></a>01039 <span class="comment">// AppendFormat() illustrating use of the</span>
<a name="l01040"></a>01040 <span class="comment">// overflow handler </span>
<a name="l01041"></a>01041 <span class="comment">//</span>
<a name="l01042"></a>01042 _LIT(KTitleOverflowHandler,<span class="stringliteral">"\n--->AppendFormat() & the overflow handler"</span>);
<a name="l01043"></a>01043 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KTitleOverflowHandler);
<a name="l01044"></a>01044 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf(KPressAnyKeyToContinue);
<a name="l01045"></a>01045 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch();
<a name="l01046"></a>01046
<a name="l01047"></a>01047 <span class="comment">// use the TestOverflow class as the overflow </span>
<a name="l01048"></a>01048 <span class="comment">// handler</span>
<a name="l01049"></a>01049 TBuf<16> overtgt;
<a name="l01050"></a>01050 TestOverflow theoverflow;
<a name="l01051"></a>01051
<a name="l01052"></a>01052 <span class="comment">// prime "overtgt" with data (of length 14)</span>
<a name="l01053"></a>01053 _LIT(KTextabcdefghijklmn,<span class="stringliteral">"abcdefghijklmn"</span>);
<a name="l01054"></a>01054 overtgt = KTextabcdefghijklmn;
<a name="l01055"></a>01055
<a name="l01056"></a>01056 <span class="comment">// Format string contains just literal</span>
<a name="l01057"></a>01057 <span class="comment">// text and no embedded commands.</span>
<a name="l01058"></a>01058 <span class="comment">// Length of literal text is 3</span>
<a name="l01059"></a>01059 <span class="comment">// 14+3 > max length of "overtgt" and </span>
<a name="l01060"></a>01060 <span class="comment">// so theoverflow.Overflow() will be invoked</span>
<a name="l01061"></a>01061
<a name="l01062"></a>01062 _LIT(KTextopq,<span class="stringliteral">"opq"</span>);
<a name="l01063"></a>01063 overtgt.AppendFormat(KTextopq,&theoverflow);
<a name="l01064"></a>01064
<a name="l01065"></a>01065 <span class="comment">// NB omitting the 2nd parameter, giving:</span>
<a name="l01066"></a>01066 <span class="comment">// overtgt.AppendFormat(KTextopq);</span>
<a name="l01067"></a>01067 <span class="comment">// results in a panic.</span>
<a name="l01068"></a>01068 }
<a name="l01069"></a>01069
<a name="l01070"></a>01070
<a name="l01071"></a>01071
<a name="l01072"></a>01072
<a name="l01073"></a>01073
<a name="l01074"></a>01074
<a name="l01075"></a>01075
<a name="l01076"></a>01076
<a name="l01077"></a>01077
</pre></div><hr size="1"><address style="text-align: right;"><small>Generated on Thu Jan 21 10:32:55 2010 for TB10.1 Example Applications by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.3 </small></address>
</body>
</html>