{\rtf1\adeflang1025\ansi\ansicpg1252\uc2\adeff0\deff0\stshfdbch0\stshfloch0\stshfhich0\stshfbi0\deflang1033\deflangfe2052\themelang1033\themelangfe0\themelangcs0{\fonttbl{\f0\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman;}{\f1\fbidi \fswiss\fcharset0\fprq2{\*\panose 020b0604020202020204}Arial;}

{\f2\fbidi \fmodern\fcharset0\fprq1{\*\panose 02070309020205020404}Courier New;}{\f3\fbidi \froman\fcharset2\fprq2{\*\panose 05050102010706020507}Symbol;}{\f7\fbidi \fswiss\fcharset0\fprq2{\*\panose 020b0604020202030204}Helv{\*\falt Arial};}

{\f10\fbidi \fnil\fcharset2\fprq2{\*\panose 05000000000000000000}Wingdings;}{\f13\fbidi \fnil\fcharset134\fprq2{\*\panose 02010600030101010101}\'cb\'ce\'cc\'e5{\*\falt ??????\'a1\'a7????};}

{\f34\fbidi \froman\fcharset0\fprq2{\*\panose 02040503050406030204}Cambria Math;}{\f38\fbidi \fswiss\fcharset0\fprq2{\*\panose 020b0604030504040204}Tahoma;}{\f39\fbidi \fswiss\fcharset0\fprq2{\*\panose 020b0604030504040204}Verdana;}

{\f40\fbidi \fnil\fcharset134\fprq2{\*\panose 00000000000000000000}@\'cb\'ce\'cc\'e5;}{\flomajor\f31500\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman;}

{\fdbmajor\f31501\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman;}{\fhimajor\f31502\fbidi \froman\fcharset0\fprq2{\*\panose 02040503050406030204}Cambria;}

{\fbimajor\f31503\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman;}{\flominor\f31504\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman;}

{\fdbminor\f31505\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman;}{\fhiminor\f31506\fbidi \fswiss\fcharset0\fprq2{\*\panose 020f0502020204030204}Calibri;}

{\fbiminor\f31507\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman;}{\f42\fbidi \froman\fcharset238\fprq2 Times New Roman CE;}{\f43\fbidi \froman\fcharset204\fprq2 Times New Roman Cyr;}

{\f45\fbidi \froman\fcharset161\fprq2 Times New Roman Greek;}{\f46\fbidi \froman\fcharset162\fprq2 Times New Roman Tur;}{\f47\fbidi \froman\fcharset177\fprq2 Times New Roman (Hebrew);}{\f48\fbidi \froman\fcharset178\fprq2 Times New Roman (Arabic);}

{\f49\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic;}{\f50\fbidi \froman\fcharset163\fprq2 Times New Roman (Vietnamese);}{\f52\fbidi \fswiss\fcharset238\fprq2 Arial CE;}{\f53\fbidi \fswiss\fcharset204\fprq2 Arial Cyr;}

{\f55\fbidi \fswiss\fcharset161\fprq2 Arial Greek;}{\f56\fbidi \fswiss\fcharset162\fprq2 Arial Tur;}{\f57\fbidi \fswiss\fcharset177\fprq2 Arial (Hebrew);}{\f58\fbidi \fswiss\fcharset178\fprq2 Arial (Arabic);}

{\f59\fbidi \fswiss\fcharset186\fprq2 Arial Baltic;}{\f60\fbidi \fswiss\fcharset163\fprq2 Arial (Vietnamese);}{\f62\fbidi \fmodern\fcharset238\fprq1 Courier New CE;}{\f63\fbidi \fmodern\fcharset204\fprq1 Courier New Cyr;}

{\f65\fbidi \fmodern\fcharset161\fprq1 Courier New Greek;}{\f66\fbidi \fmodern\fcharset162\fprq1 Courier New Tur;}{\f67\fbidi \fmodern\fcharset177\fprq1 Courier New (Hebrew);}{\f68\fbidi \fmodern\fcharset178\fprq1 Courier New (Arabic);}

{\f69\fbidi \fmodern\fcharset186\fprq1 Courier New Baltic;}{\f70\fbidi \fmodern\fcharset163\fprq1 Courier New (Vietnamese);}{\f174\fbidi \fnil\fcharset0\fprq2 SimSun Western{\*\falt ??????\'a1\'a7????};}

{\f382\fbidi \froman\fcharset238\fprq2 Cambria Math CE;}{\f383\fbidi \froman\fcharset204\fprq2 Cambria Math Cyr;}{\f385\fbidi \froman\fcharset161\fprq2 Cambria Math Greek;}{\f386\fbidi \froman\fcharset162\fprq2 Cambria Math Tur;}

{\f389\fbidi \froman\fcharset186\fprq2 Cambria Math Baltic;}{\f422\fbidi \fswiss\fcharset238\fprq2 Tahoma CE;}{\f423\fbidi \fswiss\fcharset204\fprq2 Tahoma Cyr;}{\f425\fbidi \fswiss\fcharset161\fprq2 Tahoma Greek;}

{\f426\fbidi \fswiss\fcharset162\fprq2 Tahoma Tur;}{\f427\fbidi \fswiss\fcharset177\fprq2 Tahoma (Hebrew);}{\f428\fbidi \fswiss\fcharset178\fprq2 Tahoma (Arabic);}{\f429\fbidi \fswiss\fcharset186\fprq2 Tahoma Baltic;}

{\f430\fbidi \fswiss\fcharset163\fprq2 Tahoma (Vietnamese);}{\f431\fbidi \fswiss\fcharset222\fprq2 Tahoma (Thai);}{\f432\fbidi \fswiss\fcharset238\fprq2 Verdana CE;}{\f433\fbidi \fswiss\fcharset204\fprq2 Verdana Cyr;}

{\f435\fbidi \fswiss\fcharset161\fprq2 Verdana Greek;}{\f436\fbidi \fswiss\fcharset162\fprq2 Verdana Tur;}{\f439\fbidi \fswiss\fcharset186\fprq2 Verdana Baltic;}{\f440\fbidi \fswiss\fcharset163\fprq2 Verdana (Vietnamese);}

{\f444\fbidi \fnil\fcharset0\fprq2 @\'cb\'ce\'cc\'e5 Western;}{\flomajor\f31508\fbidi \froman\fcharset238\fprq2 Times New Roman CE;}{\flomajor\f31509\fbidi \froman\fcharset204\fprq2 Times New Roman Cyr;}

{\flomajor\f31511\fbidi \froman\fcharset161\fprq2 Times New Roman Greek;}{\flomajor\f31512\fbidi \froman\fcharset162\fprq2 Times New Roman Tur;}{\flomajor\f31513\fbidi \froman\fcharset177\fprq2 Times New Roman (Hebrew);}

{\flomajor\f31514\fbidi \froman\fcharset178\fprq2 Times New Roman (Arabic);}{\flomajor\f31515\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic;}{\flomajor\f31516\fbidi \froman\fcharset163\fprq2 Times New Roman (Vietnamese);}

{\fdbmajor\f31518\fbidi \froman\fcharset238\fprq2 Times New Roman CE;}{\fdbmajor\f31519\fbidi \froman\fcharset204\fprq2 Times New Roman Cyr;}{\fdbmajor\f31521\fbidi \froman\fcharset161\fprq2 Times New Roman Greek;}

{\fdbmajor\f31522\fbidi \froman\fcharset162\fprq2 Times New Roman Tur;}{\fdbmajor\f31523\fbidi \froman\fcharset177\fprq2 Times New Roman (Hebrew);}{\fdbmajor\f31524\fbidi \froman\fcharset178\fprq2 Times New Roman (Arabic);}

{\fdbmajor\f31525\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic;}{\fdbmajor\f31526\fbidi \froman\fcharset163\fprq2 Times New Roman (Vietnamese);}{\fhimajor\f31528\fbidi \froman\fcharset238\fprq2 Cambria CE;}

{\fhimajor\f31529\fbidi \froman\fcharset204\fprq2 Cambria Cyr;}{\fhimajor\f31531\fbidi \froman\fcharset161\fprq2 Cambria Greek;}{\fhimajor\f31532\fbidi \froman\fcharset162\fprq2 Cambria Tur;}

{\fhimajor\f31535\fbidi \froman\fcharset186\fprq2 Cambria Baltic;}{\fbimajor\f31538\fbidi \froman\fcharset238\fprq2 Times New Roman CE;}{\fbimajor\f31539\fbidi \froman\fcharset204\fprq2 Times New Roman Cyr;}

{\fbimajor\f31541\fbidi \froman\fcharset161\fprq2 Times New Roman Greek;}{\fbimajor\f31542\fbidi \froman\fcharset162\fprq2 Times New Roman Tur;}{\fbimajor\f31543\fbidi \froman\fcharset177\fprq2 Times New Roman (Hebrew);}

{\fbimajor\f31544\fbidi \froman\fcharset178\fprq2 Times New Roman (Arabic);}{\fbimajor\f31545\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic;}{\fbimajor\f31546\fbidi \froman\fcharset163\fprq2 Times New Roman (Vietnamese);}

{\flominor\f31548\fbidi \froman\fcharset238\fprq2 Times New Roman CE;}{\flominor\f31549\fbidi \froman\fcharset204\fprq2 Times New Roman Cyr;}{\flominor\f31551\fbidi \froman\fcharset161\fprq2 Times New Roman Greek;}

{\flominor\f31552\fbidi \froman\fcharset162\fprq2 Times New Roman Tur;}{\flominor\f31553\fbidi \froman\fcharset177\fprq2 Times New Roman (Hebrew);}{\flominor\f31554\fbidi \froman\fcharset178\fprq2 Times New Roman (Arabic);}

{\flominor\f31555\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic;}{\flominor\f31556\fbidi \froman\fcharset163\fprq2 Times New Roman (Vietnamese);}{\fdbminor\f31558\fbidi \froman\fcharset238\fprq2 Times New Roman CE;}

{\fdbminor\f31559\fbidi \froman\fcharset204\fprq2 Times New Roman Cyr;}{\fdbminor\f31561\fbidi \froman\fcharset161\fprq2 Times New Roman Greek;}{\fdbminor\f31562\fbidi \froman\fcharset162\fprq2 Times New Roman Tur;}

{\fdbminor\f31563\fbidi \froman\fcharset177\fprq2 Times New Roman (Hebrew);}{\fdbminor\f31564\fbidi \froman\fcharset178\fprq2 Times New Roman (Arabic);}{\fdbminor\f31565\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic;}

{\fdbminor\f31566\fbidi \froman\fcharset163\fprq2 Times New Roman (Vietnamese);}{\fhiminor\f31568\fbidi \fswiss\fcharset238\fprq2 Calibri CE;}{\fhiminor\f31569\fbidi \fswiss\fcharset204\fprq2 Calibri Cyr;}

{\fhiminor\f31571\fbidi \fswiss\fcharset161\fprq2 Calibri Greek;}{\fhiminor\f31572\fbidi \fswiss\fcharset162\fprq2 Calibri Tur;}{\fhiminor\f31575\fbidi \fswiss\fcharset186\fprq2 Calibri Baltic;}

{\fbiminor\f31578\fbidi \froman\fcharset238\fprq2 Times New Roman CE;}{\fbiminor\f31579\fbidi \froman\fcharset204\fprq2 Times New Roman Cyr;}{\fbiminor\f31581\fbidi \froman\fcharset161\fprq2 Times New Roman Greek;}

{\fbiminor\f31582\fbidi \froman\fcharset162\fprq2 Times New Roman Tur;}{\fbiminor\f31583\fbidi \froman\fcharset177\fprq2 Times New Roman (Hebrew);}{\fbiminor\f31584\fbidi \froman\fcharset178\fprq2 Times New Roman (Arabic);}

{\fbiminor\f31585\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic;}{\fbiminor\f31586\fbidi \froman\fcharset163\fprq2 Times New Roman (Vietnamese);}}{\colortbl;\red0\green0\blue0;\red0\green0\blue255;\red0\green255\blue255;\red0\green255\blue0;

\red255\green0\blue255;\red255\green0\blue0;\red255\green255\blue0;\red255\green255\blue255;\red0\green0\blue128;\red0\green128\blue128;\red0\green128\blue0;\red128\green0\blue128;\red128\green0\blue0;\red128\green128\blue0;\red128\green128\blue128;

\red192\green192\blue192;}{\*\defchp \fs22 }{\*\defpap \ql \li0\ri0\sa200\sl276\slmult1\widctlpar\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin0\lin0\itap0 }\noqfpromote {\stylesheet{\ql \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 

\rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 \snext0 \sqformat \spriority0 Normal;}{\s1\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault\faauto\outlinelevel0\rin0\lin0\itap0 \rtlch\fcs1 

\ab\af1\afs28\alang1025 \ltrch\fcs0 \b\f1\fs28\lang1033\langfe1033\kerning28\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext0 \slink15 \sqformat heading 1;}{\s2\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault\faauto\outlinelevel1\rin0\lin0\itap0 

\rtlch\fcs1 \ab\ai\af1\afs24\alang1025 \ltrch\fcs0 \b\i\f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext0 \slink16 \sqformat heading 2;}{

\s3\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault\faauto\outlinelevel2\rin0\lin0\itap0 \rtlch\fcs1 \af1\afs24\alang1025 \ltrch\fcs0 \f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext0 \slink17 \sqformat heading 3;}{

\s4\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault\faauto\outlinelevel3\rin0\lin0\itap0 \rtlch\fcs1 \ab\af1\afs24\alang1025 \ltrch\fcs0 \b\f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext0 \slink18 \sqformat heading 4;}{

\s5\ql \li0\ri0\sb240\sa60\widctlpar\wrapdefault\faauto\outlinelevel4\rin0\lin0\itap0 \rtlch\fcs1 \af1\afs22\alang1025 \ltrch\fcs0 \f1\fs22\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext0 \slink19 \sqformat heading 5;}{\*\cs10 

\additive \ssemihidden Default Paragraph Font;}{\*\ts11\tsrowd\trftsWidthB3\trpaddl108\trpaddr108\trpaddfl3\trpaddft3\trpaddfb3\trpaddfr3\tblind0\tblindtype3\tscellwidthfts0\tsvertalt\tsbrdrt\tsbrdrl\tsbrdrb\tsbrdrr\tsbrdrdgl\tsbrdrdgr\tsbrdrh\tsbrdrv 

\ql \li0\ri0\sa200\sl276\slmult1\widctlpar\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs22\alang1025 \ltrch\fcs0 \fs22\lang1033\langfe2052\cgrid\langnp1033\langfenp2052 \snext11 \ssemihidden \sunhideused \sqformat 

Normal Table;}{\*\cs15 \additive \rtlch\fcs1 \ab\af31503\afs32 \ltrch\fcs0 \b\fs32\lang0\langfe1033\kerning32\loch\f31502\hich\af31502\dbch\af31501\langnp0\langfenp1033 \sbasedon10 \slink1 \slocked \spriority9 Heading 1 Char;}{\*\cs16 \additive 

\rtlch\fcs1 \ab\ai\af31503\afs28 \ltrch\fcs0 \b\i\fs28\lang0\langfe1033\loch\f31502\hich\af31502\dbch\af31501\langnp0\langfenp1033 \sbasedon10 \slink2 \slocked \ssemihidden \spriority9 Heading 2 Char;}{\*\cs17 \additive \rtlch\fcs1 \ab\af31503\afs26 

\ltrch\fcs0 \b\fs26\lang0\langfe1033\loch\f31502\hich\af31502\dbch\af31501\langnp0\langfenp1033 \sbasedon10 \slink3 \slocked \ssemihidden \spriority9 Heading 3 Char;}{\*\cs18 \additive \rtlch\fcs1 \ab\af31507\afs28 \ltrch\fcs0 

\b\fs28\lang0\langfe1033\loch\f31506\hich\af31506\dbch\af31505\langnp0\langfenp1033 \sbasedon10 \slink4 \slocked \ssemihidden \spriority9 Heading 4 Char;}{\*\cs19 \additive \rtlch\fcs1 \ab\ai\af31507\afs26 \ltrch\fcs0 

\b\i\fs26\lang0\langfe1033\loch\f31506\hich\af31506\dbch\af31505\langnp0\langfenp1033 \sbasedon10 \slink5 \slocked \ssemihidden \spriority9 Heading 5 Char;}{\s20\ql \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 

\ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext20 \slink21 \ssemihidden footnote text;}{\*\cs21 \additive \rtlch\fcs1 \af0\afs20 \ltrch\fcs0 \fs20\lang0\langfe1033\langnp0\langfenp1033 

\sbasedon10 \slink20 \slocked \ssemihidden Footnote Text Char;}{\*\cs22 \additive \rtlch\fcs1 \af0 \ltrch\fcs0 \super \sbasedon10 \ssemihidden footnote reference;}{\s23\ql \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \cbpat9 \rtlch\fcs1 

\af38\afs20\alang1025 \ltrch\fcs0 \f38\fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext23 \slink24 \ssemihidden \styrsid9966710 Document Map;}{\*\cs24 \additive \rtlch\fcs1 \af38\afs16 \ltrch\fcs0 

\f38\fs16\lang0\langfe1033\langnp0\langfenp1033 \sbasedon10 \slink23 \slocked \ssemihidden Document Map Char;}{\*\ts25\tsrowd\trbrdrt\brdrs\brdrw10 \trbrdrl\brdrs\brdrw10 \trbrdrb\brdrs\brdrw10 \trbrdrr\brdrs\brdrw10 \trbrdrh\brdrs\brdrw10 \trbrdrv

\brdrs\brdrw10 \trftsWidthB3\trpaddl108\trpaddr108\trpaddfl3\trpaddft3\trpaddfb3\trpaddfr3\tblind0\tblindtype3\tscellwidthfts0\tsvertalt\tsbrdrt\tsbrdrl\tsbrdrb\tsbrdrr\tsbrdrdgl\tsbrdrdgr\tsbrdrh\tsbrdrv 

\ql \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe2052\loch\f0\hich\af0\dbch\af13\cgrid\langnp1033\langfenp2052 \sbasedon11 \snext25 \styrsid3870519 Table Grid;}{

\s26\ql \li0\ri0\widctlpar\tqc\tx4320\tqr\tx8640\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 

\sbasedon0 \snext26 \slink27 \ssemihidden \sunhideused \styrsid13245431 header;}{\*\cs27 \additive \rtlch\fcs1 \af0\afs20 \ltrch\fcs0 \fs20\lang0\langfe1033\langnp0\langfenp1033 \sbasedon10 \slink26 \slocked \ssemihidden \styrsid13245431 Header Char;}{

\s28\ql \li0\ri0\widctlpar\tqc\tx4320\tqr\tx8640\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 

\sbasedon0 \snext28 \slink29 \ssemihidden \sunhideused \styrsid13245431 footer;}{\*\cs29 \additive \rtlch\fcs1 \af0\afs20 \ltrch\fcs0 \fs20\lang0\langfe1033\langnp0\langfenp1033 \sbasedon10 \slink28 \slocked \ssemihidden \styrsid13245431 Footer Char;}}

{\*\listtable{\list\listtemplateid1324391182\listsimple{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat0\levelspace0\levelindent0{\leveltext\'01*;}{\levelnumbers;}\hres0\chhres0 }{\listname ;}\listid-2}

{\list\listtemplateid-1187883360\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\leveltext\leveltemplateid134807553\'01{\uc1\u-3913 ?};}{\levelnumbers;}\f3\fbias0\hres0\chhres0 

\fi-360\li1380\jclisttab\tx1380\lin1380 }{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807555\'01o;}{\levelnumbers;}\f2\fbias0\hres0\chhres0 

\fi-360\li2100\jclisttab\tx2100\lin2100 }{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807557\'01{\uc1\u-3929 ?};}{\levelnumbers;}

\f10\fbias0\hres0\chhres0 \fi-360\li2820\jclisttab\tx2820\lin2820 }{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807553

\'01{\uc1\u-3913 ?};}{\levelnumbers;}\f3\fbias0\hres0\chhres0 \fi-360\li3540\jclisttab\tx3540\lin3540 }{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext

\leveltemplateid134807555\'01o;}{\levelnumbers;}\f2\fbias0\hres0\chhres0 \fi-360\li4260\jclisttab\tx4260\lin4260 }{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext

\leveltemplateid134807557\'01{\uc1\u-3929 ?};}{\levelnumbers;}\f10\fbias0\hres0\chhres0 \fi-360\li4980\jclisttab\tx4980\lin4980 }{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0

{\leveltext\leveltemplateid134807553\'01{\uc1\u-3913 ?};}{\levelnumbers;}\f3\fbias0\hres0\chhres0 \fi-360\li5700\jclisttab\tx5700\lin5700 }{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360

\levelindent0{\leveltext\leveltemplateid134807555\'01o;}{\levelnumbers;}\f2\fbias0\hres0\chhres0 \fi-360\li6420\jclisttab\tx6420\lin6420 }{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360

\levelindent0{\leveltext\leveltemplateid134807557\'01{\uc1\u-3929 ?};}{\levelnumbers;}\f10\fbias0\hres0\chhres0 \fi-360\li7140\jclisttab\tx7140\lin7140 }{\listname ;}\listid54819243}{\list\listtemplateid1466231512\listhybrid{\listlevel\levelnfc0

\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\leveltext\leveltemplateid134807567\'02\'00.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li720\jclisttab\tx720\lin720 }{\listlevel\levelnfc4

\levelnfcn4\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807577\'02\'01.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li1440\jclisttab\tx1440\lin1440 }

{\listlevel\levelnfc2\levelnfcn2\leveljc2\leveljcn2\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807579\'02\'02.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-180\li2160

\jclisttab\tx2160\lin2160 }{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807567\'02\'03.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 

\hres0\chhres0 \fi-360\li2880\jclisttab\tx2880\lin2880 }{\listlevel\levelnfc4\levelnfcn4\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807577\'02\'04.;}{\levelnumbers\'01;}\rtlch\fcs1 

\af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li3600\jclisttab\tx3600\lin3600 }{\listlevel\levelnfc2\levelnfcn2\leveljc2\leveljcn2\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807579\'02\'05.;}{\levelnumbers

\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-180\li4320\jclisttab\tx4320\lin4320 }{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807567

\'02\'06.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li5040\jclisttab\tx5040\lin5040 }{\listlevel\levelnfc4\levelnfcn4\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext

\leveltemplateid134807577\'02\'07.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li5760\jclisttab\tx5760\lin5760 }{\listlevel\levelnfc2\levelnfcn2\leveljc2\leveljcn2\levelfollow0\levelstartat1\lvltentative\levelspace360

\levelindent0{\leveltext\leveltemplateid134807579\'02\'08.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-180\li6480\jclisttab\tx6480\lin6480 }{\listname ;}\listid423111094}{\list\listtemplateid-688208078\listhybrid{\listlevel

\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\leveltext\leveltemplateid134807567\'02\'00.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li720\jclisttab\tx720\lin720 }{\listlevel

\levelnfc4\levelnfcn4\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807577\'02\'01.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li1440

\jclisttab\tx1440\lin1440 }{\listlevel\levelnfc2\levelnfcn2\leveljc2\leveljcn2\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807579\'02\'02.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 

\hres0\chhres0 \fi-180\li2160\jclisttab\tx2160\lin2160 }{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807567\'02\'03.;}{\levelnumbers\'01;}\rtlch\fcs1 

\af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li2880\jclisttab\tx2880\lin2880 }{\listlevel\levelnfc4\levelnfcn4\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807577\'02\'04.;}{\levelnumbers

\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li3600\jclisttab\tx3600\lin3600 }{\listlevel\levelnfc2\levelnfcn2\leveljc2\leveljcn2\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807579

\'02\'05.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-180\li4320\jclisttab\tx4320\lin4320 }{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360\levelindent0{\leveltext

\leveltemplateid134807567\'02\'06.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li5040\jclisttab\tx5040\lin5040 }{\listlevel\levelnfc4\levelnfcn4\leveljc0\leveljcn0\levelfollow0\levelstartat1\lvltentative\levelspace360

\levelindent0{\leveltext\leveltemplateid134807577\'02\'07.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-360\li5760\jclisttab\tx5760\lin5760 }{\listlevel\levelnfc2\levelnfcn2\leveljc2\leveljcn2\levelfollow0\levelstartat1

\lvltentative\levelspace360\levelindent0{\leveltext\leveltemplateid134807579\'02\'08.;}{\levelnumbers\'01;}\rtlch\fcs1 \af0 \ltrch\fcs0 \hres0\chhres0 \fi-180\li6480\jclisttab\tx6480\lin6480 }{\listname ;}\listid1301228057}}{\*\listoverridetable

{\listoverride\listid-2\listoverridecount1{\lfolevel\listoverrideformat{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelold\levelspace0\levelindent283{\leveltext\'01{\uc1\u-3913 ?};}{\levelnumbers;}\f3\fbias0 

\fi-283\li283\lin283 }}\ls1}{\listoverride\listid54819243\listoverridecount0\ls2}{\listoverride\listid423111094\listoverridecount0\ls3}{\listoverride\listid1301228057\listoverridecount0\ls4}}{\*\revtbl {Unknown;}{x120li;}}{\*\rsidtbl \rsid263778\rsid532711\rsid1256931\rsid1385641

\rsid2174399\rsid3870519\rsid4806205\rsid5273633\rsid6626992\rsid6646124\rsid8201307\rsid8468412\rsid9512948\rsid9847436\rsid9966710\rsid10027302\rsid10029829\rsid12140715\rsid12266512\rsid13245431\rsid13650870\rsid13834222\rsid15169297\rsid15427529

\rsid16195214\rsid16410473}{\mmathPr\mmathFont34\mbrkBin0\mbrkBinSub0\msmallFrac0\mdispDef1\mlMargin0\mrMargin0\mdefJc1\mwrapIndent1440\mintLim0\mnaryLim1}{\info{\author Preferred Customer}{\operator x120li}{\creatim\yr1999\mo3\dy16\hr14\min36}

{\revtim\yr2009\mo6\dy9\hr18\min22}{\printim\yr1999\mo3\dy17\hr16\min34}{\version18}{\edmins29}{\nofpages11}{\nofwords5165}{\nofchars33192}{\*\company Dell Computer Corporation}{\nofcharsws38281}{\vern32895}}{\*\xmlnstbl {\xmlns1 http://schemas.microsoft.

com/office/word/2003/wordml}{\xmlns2 urn:schemas-microsoft-com:office:smarttags}}\paperw11906\paperh16838\margl1800\margr1800\margt1440\margb1440\gutter0\ltrsect 

\deftab340\widowctrl\ftnbj\aenddoc\revisions\trackmoves1\trackformatting1\donotembedsysfont0\relyonvml0\donotembedlingdata1\grfdocevents0\validatexml0\showplaceholdtext0\ignoremixedcontent0\saveinvalidxml0

\showxmlerrors0\noxlattoyen\expshrtn\noultrlspc\dntblnsbdb\nospaceforul\hyphcaps0\formshade\horzdoc\dghspace120\dgvspace120\dghorigin1701\dgvorigin1984\dghshow0\dgvshow3\jcompress\viewkind1\viewscale120\nolnhtadjtbl\rsidroot9966710 \fet0

{\*\wgrffmtfilter 013f}\ilfomacatclnup0{\*\ftnsep \ltrpar \pard\plain \ltrpar\ql \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid13245431 \chftnsep 

\par }}{\*\ftnsepc \ltrpar \pard\plain \ltrpar\ql \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid13245431 

\chftnsepc 

\par }}{\*\aftnsep \ltrpar \pard\plain \ltrpar\ql \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid13245431 

\chftnsep 

\par }}{\*\aftnsepc \ltrpar \pard\plain \ltrpar\ql \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid13245431 

\chftnsepc 

\par }}\ltrpar \sectd \ltrsect\linex0\headery709\footery709\colsx709\endnhere\sectdefaultcl\sftnbj {\*\pnseclvl1\pnlcrm\pnstart1\pnindent283\pnhang }{\*\pnseclvl2\pnf3\pnstart1\pnindent283 {\pntxtb \hich ?}}{\*\pnseclvl3\pnf3\pnstart1\pnindent283 

{\pntxtb \hich ?}}{\*\pnseclvl4\pnf3\pnstart1\pnindent283 {\pntxtb \hich ?}}{\*\pnseclvl5\pnf3\pnstart1\pnindent283 {\pntxtb \hich ?}}{\*\pnseclvl6\pnf3\pnstart1\pnindent283 {\pntxtb \hich ?}}{\*\pnseclvl7\pnf3\pnstart1\pnindent283 {\pntxtb \hich ?}}

{\*\pnseclvl8\pnf3\pnstart1\pnindent283 {\pntxtb \hich ?}}{\*\pnseclvl9\pnf3\pnstart1\pnindent283 {\pntxtb \hich ?}}\pard\plain \ltrpar\s1\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault\faauto\outlinelevel0\rin0\lin0\itap0 \rtlch\fcs1 

\ab\af1\afs28\alang1025 \ltrch\fcs0 \b\f1\fs28\lang1033\langfe1033\kerning28\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af1 \ltrch\fcs0 \insrsid6646124 Converting text between different character-encoding systems

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

EPOC machines internally store text encoded in Unicode - the character set}{\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn {\footnote \ltrpar \pard\plain \ltrpar\s20\qj \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 

\af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  The term \'93character set\'94

 is used throughout this document to refer to }{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124 a set of characters and their encodings}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  as defin

ed by a particular body (e.g. a government organization, a consortium, etc).}}}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 defined by The Unicode Consortium. However, much of the text sent between the EPOC machine and the outside world (e.g. in emails) will be encoded in character sets other than Uni

code. The CHARCONV component provides a DLL for converting text (both ways) between Unicode and other standard characters sets. It also supports converting (both ways) between }{\rtlch\fcs1 \af0 \ltrch\fcs0 

\deleted\revauthdel1\revdttmdel1188449428\insrsid6646124\delrsid9847436 2-byte Unicode (also known as }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 UCS-2}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\deleted\revauthdel1\revdttmdel1188449428\insrsid6646124\delrsid9847436 )}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  and }{\rtlch\fcs1 \af0 \ltrch\fcs0 \deleted\revauthdel1\revdttmdel1188449428\insrsid6646124\delrsid9847436 its }{\rtlch\fcs1 \af0 

\ltrch\fcs0 \deleted\revauthdel1\revdttmdel1188449422\insrsid6646124\delrsid5273633 two }{\rtlch\fcs1 \af0 \ltrch\fcs0 \deleted\revauthdel1\revdttmdel1188449428\insrsid6646124\delrsid9847436 transformation format}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\deleted\revauthdel1\revdttmdel1188449422\insrsid6646124\delrsid5273633 s}{\rtlch\fcs1 \af0 \ltrch\fcs0 \deleted\revauthdel1\revdttmdel1188449428\insrsid6646124\delrsid9847436  }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 UTF-7}{\rtlch\fcs1 \af0 

\ltrch\fcs0 \cf0\revised\revauth1\revdttm1188449428\insrsid9847436 , as well as between UTF-16}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 and UTF-8. There is no direct way to convert between UTF-7 and UTF-8 though - in fact CHARCONV as a whole does not provide any direct conversion facilities other than to or from Unicode (UCS-2}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\cf0\revised\revauth1\revdttm1188449423\insrsid5273633  or }{\rtlch\fcs1 \af0 \ltrch\fcs0 \cf0\revised\revauth1\revdttm1188449421\insrsid5273633 UTF-16}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 ).

\par }\pard\plain \ltrpar\s2\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault\faauto\outlinelevel1\rin0\lin0\itap0 \rtlch\fcs1 \ab\ai\af1\afs24\alang1025 \ltrch\fcs0 \b\i\f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af1 

\ltrch\fcs0 \insrsid6646124 Converting text between Unicode and other standard character sets

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 The class }{\rtlch\fcs1 

\af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  is provided for converting text between Unicode and other standard character sets. The public parts of the class are shown below:

\par }\pard \ltrpar\qj \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

\par }\pard \ltrpar\ql \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af2\afs14 \ltrch\fcs0 \f2\fs14\insrsid6646124 class CCnvCharacterSetConverter : public CBase

\par \tab \{

\par public:

\par \tab enum TAvailability

\par \tab \tab \{

\par \tab \tab EAvailable,

\par \tab \tab ENotAvailable

\par \tab \tab \};

\par \tab enum TError

\par \tab \tab \{

\par \tab \tab EErrorIllFormedInput=-1

\par \tab \tab \};

\par \tab enum TEndianness

\par \tab \tab \{

\par \tab \tab ELittleEndian,

\par \tab \tab EBigEndian

\par \tab \tab \};

\par \tab enum \{KStateDefault=0\};

\par \tab struct SCharacterSet

\par \tab \tab \{

\par \tab \tab inline TUint Identifier() const;

\par \tab \tab inline TBool NameIsFileName() const;

\par \tab \tab inline TPtrC Name() const;

\par \tab private:

\par \tab \tab // ...

\par \tab \tab \};

\par public:

\par \tab IMPORT_C static CCnvCharacterSetConverter* NewL();

\par \tab IMPORT_C static CCnvCharacterSetConverter* NewLC();

\par \tab IMPORT_C virtual ~CCnvCharacterSetConverter();

\par \tab IMPORT_C static CArrayFix<SCharacterSet>* CreateArrayOfCharacterSetsAvailableL(RFs&);

\par \tab IMPORT_C static CArrayFix<SCharacterSet>* CreateArrayOfCharacterSetsAvailableLC(RFs&);

\par \tab IMPORT_C TUint ConvertStandardNameOfCharacterSetToIdentifierL(const TDesC8&, RFs&);

\par \tab IMPORT_C HBufC8* ConvertCharacterSetIdentifierToStandardNameL(TUint, RFs&);

\par \tab IMPORT_C TUint ConvertMibEnumOfCharacterSetToIdentifierL(TInt, RFs&);

\par \tab IMPORT_C TInt ConvertCharacterSetIdentifierToMibEnumL(TUint, RFs&);

\par \tab IMPORT_C void PrepareToConvertToOrFromL(TUint, const CArrayFix<SCharacterSet>&, RFs&);

\par \tab IMPORT_C TAvailability PrepareToConvertToOrFromL(TUint, RFs&);

\par \tab IMPORT_C void SetDefaultEndiannessOfForeignCharacters(TEndianness);

\par \tab IMPORT_C void SetReplacementForUnconvertibleUnicodeCharactersL(const TDesC8&);

\par \tab IMPORT_C TInt ConvertFromUnicode(TDes8&, const TDesC16&) const;

\par \tab IMPORT_C TInt ConvertFromUnicode(TDes8&, const TDesC16&, TInt&) const;

\par \tab IMPORT_C TInt ConvertFromUnicode(TDes8&, const TDesC16&, TInt&, TInt&) const;

\par \tab IMPORT_C TInt ConvertToUnicode(TDes16&, const TDesC8&, TInt&) const;

\par \tab IMPORT_C TInt ConvertToUnicode(TDes16&, const TDesC8&, TInt&, TInt&) const;

\par \tab IMPORT_C TInt ConvertToUnicode(TDes16&, const TDesC8&, TInt&, TInt&, TInt&) const;

\par private:

\par \tab // ...

\par \tab \};

\par }\pard\plain \ltrpar\s3\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault\faauto\outlinelevel2\rin0\lin0\itap0 \rtlch\fcs1 \af1\afs24\alang1025 \ltrch\fcs0 \f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af1 \ltrch\fcs0 

\insrsid6646124 Overview

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

There are two basic stages involved in using a }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 object to change the encoding of a piece of text from one character set to another. It is first necessary to select the foreign character set of interest. Then having done that, t

he actual conversion of text to or from that character set can be performed. Selecting the foreign character set is done by calling one of the overloads of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 PrepareToConvertToOrFromL}{\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124 . Text conversion itself is done by calling one of the overloads of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  or }{\rtlch\fcs1 \af2 \ltrch\fcs0 

\f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 .

\par }\pard\plain \ltrpar\s3\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault\faauto\outlinelevel2\rin0\lin0\itap0 \rtlch\fcs1 \af1\afs24\alang1025 \ltrch\fcs0 \f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af1 \ltrch\fcs0 

\insrsid6646124 Creating and destroying }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af1 \ltrch\fcs0 \insrsid6646124  objects

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 Objects of the }{

\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  class are created by calling either of the static member functions }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 NewL}{

\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  or }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 NewLC}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 , the latter leaving the object on the clean

up stack. These objects are created on the heap and are thus destroyed using the }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 delete}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 operator as normal. Creating one of these objects only involves some allocation on the heap and initialization of member data - it does not involve anything as onerous as scanning for files, or loading data from a file. Such \'93heavyweight\'94

 activities are done at a later stage (see \'93Selecting the foreign character set to convert to/from\'94 below).

\par }\pard\plain \ltrpar\s3\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault\faauto\outlinelevel2\rin0\lin0\itap0 \rtlch\fcs1 \af1\afs24\alang1025 \ltrch\fcs0 \f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af1 \ltrch\fcs0 

\insrsid6646124 The member functions for doing the conversion

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

The most important member functions of the class are }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  and }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 

\af0 \ltrch\fcs0 \insrsid6646124 . These all convert the text passed in the second parameter and output the resulting text in the first parameter. Sixteen-bit descriptors are used to hold any text encoded in Unicode (UCS-2}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\cf0\revised\revauth1\revdttm1188449427\insrsid9847436  }{\rtlch\fcs1 \af0 \ltrch\fcs0 \cf0\revised\revauth1\revdttm1188449429\insrsid12266512 or}{\rtlch\fcs1 \af0 \ltrch\fcs0 \cf0\revised\revauth1\revdttm1188449427\insrsid9847436  }{\rtlch\fcs1 \af0 

\ltrch\fcs0 \cf0\revised\revauth1\revdttm1188404155\insrsid13245431 UTF-16}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 )

, and eight-bit descriptors are used to hold any text encoded in any other character set. Foreign character sets (i.e. character sets other than Unicode) may use a single byte per character (e.g. Code Page 1252) or more than one byte per character (e.g. C

hina\rquote s GB 2312-80) or even a variable number of bytes per character (e.g. Japan\rquote s Shift-JIS) - hence the need to use eight-bit descriptors.

\par The third parameter to the second two overloads of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  (which is purely an output parameter) }{\rtlch\fcs1 \af0 \ltrch\fcs0 

\insrsid10029829\charrsid6626992 holds the

 indices of each Unicode character in the source text that could not be converted.  This is because the foreign character set has no equivalents for these Unicode characters. It can record, at a maximum, 25 unconvertible characters. So if the input source

 text has more than 25 }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid15427529\charrsid6626992 unconvertible}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid10029829\charrsid6626992  characters, only the first 25 of these characters will be recorded.}{\rtlch\fcs1 \af0 

\ltrch\fcs0 \cf1\insrsid10029829  }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid10029829  }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid9966710  }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 Similarly, the fourth parameters to the second two overloads of }{

\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 (which are also purely output parameters) tell the caller the number of characters in the input descriptor that could not be converted into Unicode (for the analogous reason). In neither }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 

ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  or }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  is conversion aborted because

 of unconvertible characters. (What is written to the output descriptor for such unconvertible characters is discussed in a separate paragraph below.) The purpose of these parameters in the case of both }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 

ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  and }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  is to allow t

he caller to gauge a rough idea of the proportion of characters that are failing to be converted. (Recall that a character in the input descriptor to }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\insrsid6646124  does not necessarily occupy only a single byte of that descriptor. However, since Unicode

 is intended to cover all possible characters and thus be the superset of all character sets, this will rarely, if ever, report anything other than zero characters, although it will report the existence of unconvertible characters if the input descriptor 

contains illegal \'93characters\'94, i.e. values not actually in the foreign character set.)

\par The last parameter to the last overloads of both }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  and }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124  (these are again purely output parameters) indicates the index of the first character (or in the case of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

, the index of the first }{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124 byte}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 of the first character) in the input descriptor that could not be converted. If all the characters in the input descriptor could be converted, this parameter is set to a negative value.

\par The }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 TInt}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  value returned by }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  and }{

\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  is either one of the negative error values defined in }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 

\af0 \ltrch\fcs0 \insrsid6646124 \rquote s }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 enum TError}{\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn {\footnote \ltrpar \pard\plain \ltrpar

\s20\qj \li0\ri0\widctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn }{\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124  Although there is currently only one error code in }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter::TError}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 , this ma

y be extended in the future, so CHARCONV clients should program defensively to allow for this.}}}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 or the number of elements left at the end of the input descriptor which were not converted, either (i) because there was no room left in the output descriptor, 

or (ii) because the input descriptor ended with an incomplete sequence (e.g. half-way through a multi-byte character).

\par {\pntext\pard\plain\ltrpar \rtlch\fcs1 \af0\afs20 \ltrch\fcs0 \f3\fs20\lang1033\langfe1033\langfenp1033\insrsid6646124 \loch\af3\dbch\af0\hich\f3 \'b7\tab}}\pard \ltrpar\qj \fi-283\li283\ri0\widctlpar\wrapdefault{\*\pn \pnlvlblt\ilvl0\ls1\pnrnot0

\pnf3\pnstart1\pnindent283\pnhang {\pntxtb \hich \'b7}}\faauto\ls1\rin0\lin283\itap0\pararsid9966710 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

The ability to do partial conversions means that the CHARCONV client does not have to try to guess how big to make the output descript

or for a given input descriptor, they can simply do the conversion in a loop using a smallish output descriptor (an output descriptor whose }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 MaxLength()}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 is less than about 20 elements would not be recommended) - the code in the \'93Sample code\'94 section below g

ives a demonstration of how to do this. It is worth noting that even if the output descriptor was not big enough to hold the entire converted input text, it will not necessarily be full in the sense of have its }{\rtlch\fcs1 \af2 \ltrch\fcs0 

\f2\insrsid6646124 Length()}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  equal its }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 MaxLength()}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 . The only sure

 way to find out whether the whole input descriptor has been converted is to test whether the return value (if not negative) is zero or not.

\par {\pntext\pard\plain\ltrpar \rtlch\fcs1 \af0\afs20 \ltrch\fcs0 \f3\fs20\lang1033\langfe1033\langfenp1033\insrsid6646124 \loch\af3\dbch\af0\hich\f3 \'b7\tab}}\pard \ltrpar\qj \fi-283\li283\ri0\widctlpar\wrapdefault{\*\pn \pnlvlblt\ilvl0\ls1\pnrnot0

\pnf3\pnstart1\pnindent283\pnhang {\pntxtb \hich \'b7}}\faauto\ls1\rin0\lin283\itap0\pararsid9966710 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

The ability to cope with an input descriptor being truncated is useful if the client cannot guarantee whether th

e input descriptor will be complete, e.g. if they themselves are receiving it in chunks from an external source. All that the client needs to do to handle this situation is to add the specified number of descriptor elements to the start of the input descr

iptor passed to the next call. However, there is a binary compatibility issue here. For those clients whose input descriptor is known to be complete, if they perform the sort of loop found in the first two examples in the \'93Sample code\'94

 section, they would g

et into an infinite loop if the input descriptor was corrupt such that it ended with an incomplete sequence, as the conversion function would always return a value greater than zero. To avoid this problem arising, the behavior of the conversion functions 

is actually such that if none of the input descriptor can be consumed because it consists }{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124 exclusively}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  of an incomplete sequence, the error }{\rtlch\fcs1 

\af2 \ltrch\fcs0 \f2\insrsid6646124 EErrorIllFormedInput}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  (defined in }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 \rquote s }{

\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 enum TError}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 ) will be returned. In order for this error not to be returned when the presence of an incomplete sequence at the end of the input descriptor does }{

\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124 not}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  mean it is corrupt, the input descriptor must be long enough such that it cannot consist exclusively of an incomplete sequence - an input descriptor of

 at least 20 elements should be plenty long enough. (The third example in the \'93Sample code\'94 section below gives an illustration of how to use CHARCONV to convert fragmented input.)

\par }\pard \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 The third parameter to }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 

ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  is used to save state information across multiple calls to }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 where each call starts off where the previous call reached in the input descriptor. At the start of each such series of calls to }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 this parameter must be set to }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter::KStateDefault}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  and thereafter not tampered with, but simply passed in to each }{\rtlch\fcs1 \af2 

\ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  call.

\par }\pard\plain \ltrpar\s3\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\outlinelevel2\rin0\lin0\itap0 \rtlch\fcs1 \af1\afs24\alang1025 \ltrch\fcs0 

\f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af1 \ltrch\fcs0 \insrsid6646124 Selecting the foreign character set to convert to/from

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124 When the }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  object has been created, before either }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 

ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  or }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 can be called, it is necessary to state which foreign character set is to be converted to/from. This is done by calling either of the two overloads of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 PrepareToConvertToOrFromL}{\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124 . Each takes the identifier (a Symbian-defined UID) of the required character set as it\rquote s first parameter, and a file-server session object as it\rquote 

s last parameter. The first overload requires the array returned by either of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 \rquote s static member functions }{\rtlch\fcs1 \af2 

\ltrch\fcs0 \f2\insrsid6646124 CreateArrayOfCharacterSetsAvailableL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  or }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CreateArrayOfCharacterSetsAvailableLC}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 to be passed in as its second parameter. This array contains one }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter::SCharacterSet}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 item for each foreign character set that is available (at run-time) for text conversion. The }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 Identifier}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  member function of }{\rtlch\fcs1 \af2 \ltrch\fcs0 

\f2\insrsid6646124 SCharacterSet}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  returns the Symbian-UID identifier of the character set represented by that object. (See below for a discussion of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 

SCharacterSet}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 \rquote s other member functions.) Creating this array is not required for calling the second overload.

\par If the first overload of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 PrepareToConvertToOrFromL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 is used, the character-set identifier passed into the first parameter must correspond to an item in the array passed to the second parameter (i.e. that item\rquote s }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 Identifier}{\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124  member function returns the same number), or a panic will oc

cur. The second overload, however, is less demanding - the character set identified in the first parameter does not have to be available at run-time. Depending on whether the character set is available or not, it returns }{\rtlch\fcs1 \af2 \ltrch\fcs0 

\f2\insrsid6646124 EAvailable}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  or }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ENotAvailable}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  (from }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 C

CnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 \rquote s }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 enum TAvailability}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 ). Calls to }{\rtlch\fcs1 \af2 \ltrch\fcs0 

\f2\insrsid6646124 ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  or }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 convert to or from the character set whose identifier was passed into the last }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 PrepareToConvertToOrFromL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  call which did not return }{\rtlch\fcs1 \af2 

\ltrch\fcs0 \f2\insrsid6646124 ENotAvailable}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 . If all calls previously returned }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ENotAvailable}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

, a panic will occur.

\par The two overloads of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 PrepareToConvertToOrFromL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 are designed for different usage. In a situation where it may be necessary to present the user with a list of all the possible character sets for them to c

hoose which to convert to/from, then the first overload would need to be used. However, if the CHARCONV client wishes to convert the content of, say, an email message, or an HTML document, i.e. something that describes within itself what character set its

 content is in, then the second overload would be more appropriate.

\par }\pard\plain \ltrpar\s3\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\outlinelevel2\rin0\lin0\itap0 \rtlch\fcs1 \af1\afs24\alang1025 \ltrch\fcs0 

\f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af1 \ltrch\fcs0 \insrsid6646124 Efficiency considerations

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124 The first overload of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 PrepareToConvertToOrFromL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 should be used in preference to the second overload if a number of different character sets are to be converted to/from in a short space of time. The reason for this is that the second overload, unlike the first, internally has to do a file scan}{

\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn {\footnote \ltrpar \pard\plain \ltrpar\s20\qj \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 

\fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  The second overload of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 

PrepareToConvertToOrFromL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  is fast to call for if the required conversion data/code is hard-coded wit

hin CHARCONV (this currently applies to Code Page 1252, ISO 8859-1, ASCII and SMS 7-bit, and also the Unicode transformation formats UTF-7 and UTF-8). For other character sets, file scanning is necessary.}}}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 which is similar to the one performed by }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CreateArrayOfCharacterSetsAvailableL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  and }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 

CreateArrayOfCharacterSetsAvailableLC}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

. Thus it is more efficient to do the file-scanning once to start with by calling one of these array-creating functions, and then pass that array in to the first overload of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 PrepareToConvertToOrFromL}{

\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 each time the target/source character set is to be changed (first checking to see if each required character set is in the array, to avoid the panic that occurs if it is not). However, if the different calls to }{\rtlch\fcs1 \af2 \ltrch\fcs0 

\f2\insrsid6646124 PrepareToConvertToOrFromL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  are spread out over a }{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124 considerable}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 time, it may be best to use the second overload for this as it will perform the necessary re-scanning of files each time and thus pick up any new files that have been installed in the mean time.

\par }\pard\plain \ltrpar\s3\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\outlinelevel2\rin0\lin0\itap0 \rtlch\fcs1 \af1\afs24\alang1025 \ltrch\fcs0 

\f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 SCharacterSet}{\rtlch\fcs1 \af1 \ltrch\fcs0 \insrsid6646124  and the names of foreign character sets

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af2 

\ltrch\fcs0 \f2\insrsid6646124 SCharacterSet}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 \rquote s member function }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 Name}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 returns the full path and file name of the conversion-data file for that character set, although for those character sets for which CHARCONV hard codes conversion data (rather than getting it from a file) }{\rtlch\fcs1 \af2 \ltrch\fcs0 

\f2\insrsid6646124 Name}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  returns an arbitrary name for that character set. }{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124 

Note that the name returned cannot be treated as an Internet-standard name. Converting between the Internet-standard names of character sets and the Symbian-UID identifiers that }{\rtlch\fcs1 \ai\af2 \ltrch\fcs0 \i\f2\insrsid6646124 Prepar

eToConvertToOrFromL}{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124  expects is provided by the member functions }{\rtlch\fcs1 \ai\af2 \ltrch\fcs0 \i\f2\insrsid6646124 ConvertStandardNameOfCharacterSetToIdentifierL}{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 

\i\insrsid6646124  and }{\rtlch\fcs1 \ai\af2 \ltrch\fcs0 \i\f2\insrsid6646124 ConvertCharacterSetIdentifierToStandardNameL}{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124  (see \'93Other member functions\'94 below).}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\insrsid6646124  Also, the name returned is locale-independent and therefore should be hidden from the user}{\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn {\footnote \ltrpar \pard\plain \ltrpar\s20\qj \li0\ri0\widctlpar\wrapdefault{\*\pn 

\pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn }{\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124  If a character-set name needs to be shown to the user (and therefore is locale-dependent), that name should to be mapped to the locale-independent name returned by }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 Name}{

\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  by some software at a higher level than CHARCONV.}}}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 . }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 NameIsFileName}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\insrsid6646124  returns whether }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 Name}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  returns a file name or just an arbitrary name. (This may prove useful, for example, to find out whether F32\rquote 

s file-name parsing class }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 TParse}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  can be used on the return value of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 Name}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\insrsid6646124 .)

\par }\pard\plain \ltrpar\s3\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\outlinelevel2\rin0\lin0\itap0 \rtlch\fcs1 \af1\afs24\alang1025 \ltrch\fcs0 

\f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af1 \ltrch\fcs0 \insrsid6646124 Other member functions

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124 For character sets using more than one byte per character, the \'93endian\'94-ness of those characters may be defined or left open}{\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn {\footnote \ltrpar 

\pard\plain \ltrpar\s20\qj \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 

\cs22\super\insrsid6646124 \chftn }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  As an example of each, {\*\xmlopen\xmlns2{\factoidname country-region}}{\*\xmlopen\xmlns2{\factoidname place}}China{\*\xmlclose}{\*\xmlclose}\rquote 

s GB2312-80 defines the byte order of its two-byte characters, whereas Unicode leaves the byte order of its two-byte characters undefined.}}}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

. Although none of the foreign character sets currently supported by CHARCONV are of undefined endianness, the member function }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 SetDefaultEndiannessOfForeignCharacters}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\insrsid6646124  which takes either }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ELittleEndian}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  or }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 EBigEndian}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\insrsid6646124  (from }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 \rquote s }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 enum TEndianness}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\insrsid6646124 ) allows the CHARCONV client to set the endianness that }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  and }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 

ConvertToUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  use when converting to or from foreign character sets of undefined endianness.

\par When converting to Unicode, e

ach character in the input descriptor for which there is no equivalent in Unicode is converted to the Unicode character specifically designated for that purpose - 0xFFFD. (As already noted, this should rarely, if ever, be the case, unless the input is cor

rupt.) When converting the other way, each foreign character set provides a default character to be used for each Unicode character lacking an equivalent in that character set. This default may be overridden by calling the member function }{\rtlch\fcs1 

\af2 \ltrch\fcs0 \f2\insrsid6646124 SetReplacementForUnconvertibleUnicodeCharactersL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 . It should be noted that }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 PrepareToConvertToOrFromL}{\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124  undoes the effect of any previous }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 SetReplacementForUnconvertibleUnicodeCharactersL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 call, and thus for the latter to have any effect, it should be called between the }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 PrepareToConvertToOrFromL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  call and the subsequent }{\rtlch\fcs1 \af2 

\ltrch\fcs0 \f2\insrsid6646124 ConvertFromUnicode}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  call(s). The parameter to }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 SetReplacementForUnconvertibleUnicodeCharactersL}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\insrsid6646124  should be passed a single, possibly multi-byte, character, whose byte order (if multi-byte) should be little-endian if the endianness of the character set is undefined, otherwise the same endianness as is defined by the character set.

\par }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertStandardNameOfCharacterSetToIdentifierL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  is provided for the CHARCONV client to be able to find out the Symbian UID of a character set f

or a given Internet-standard name of that character set. It returns zero if the name of the character set was not known. This function can be called at any time in the }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{

\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  object\rquote s lifetime.

\par }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertCharacterSetIdentifierToStandardNameL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 is provided for the CHARCONV client to be able to find out an Internet-standard name of a character set (which is a \'93preferred MIME name\'94 where possible) for the Symbian UID of that character set. It returns }{\rtlch\fcs1 \af2 \ltrch\fcs0 

\f2\insrsid6646124 NULL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  if the UID of the character set was not known. This function can be called at any time in the }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 

\af0 \ltrch\fcs0 \insrsid6646124  object\rquote s lifetime.

\par }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertMibEnumOfCharacterSetToIdentifierL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  is provided for the CHARCONV client to be able to find out the Symbian UID of a character set for a given MIB-enum}{

\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn {\footnote \ltrpar \pard\plain \ltrpar\s20\qj \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 

\fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 \ltrch\fcs0 \cs22\super\insrsid6646124 \chftn }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  MIB enum values are defined in }{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124 

ftp.isi.edu/in-notes/iana/assignments/character-sets}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 .}}}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 of that character set. It returns zero if the name of the character set was not known. This function can be called at any time in the }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\insrsid6646124  object\rquote s lifetime.

\par }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 ConvertCharacterSetIdentifierToMibEnumL}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

 is provided for the CHARCONV client to be able to find out a MIB-enum of a character set for the Symbian UID of that character set. It returns zero if the UID of the character set was not known. This function can be called at any time in the }{

\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  object\rquote s lifetime.

\par The four functions described above all behave as follows. The first time any if them is called with a first parameter that is not in }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

\rquote s internal hard-coded list, a file scan is done to try to find out the required information from a file. The results of this are stored in the }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124  object, so that no subsequent call to }{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124 any}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  of these four functions will repeat the file scanning.

\par }\pard\plain \ltrpar\s3\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\outlinelevel2\rin0\lin0\itap0 \rtlch\fcs1 \af1\afs24\alang1025 \ltrch\fcs0 

\f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af1 \ltrch\fcs0 \insrsid6646124 Sample code

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124 The sample code below illustrates typical usage of }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CCnvCharacterSetConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 .

\par }\pard \ltrpar\qj \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

\par An example of how to convert, in small chunks, Unicode text to another character set:

\par 

\par }\pard \ltrpar\ql \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af2\afs14 \ltrch\fcs0 \f2\fs14\insrsid6646124 

LOCAL_C void ConvertUnicodeTextL(CCnvCharacterSetConverter& aCharacterSetConverter,

\par \tab \tab \tab \tab \tab \tab \tab \tab RFs& aFileServerSession,

\par \tab \tab \tab \tab \tab \tab \tab \tab TUint aForeignCharacterSet,

\par \tab \tab \tab \tab \tab \tab \tab \tab const TDesC16& aUnicodeText)

\par \tab \{

\par \tab if (aCharacterSetConverter.PrepareToConvertToOrFromL(aForeignCharacterSet, aFileServerSession)

\par \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab !=CCnvCharacterSetConverter::EAvailable)

\par \tab \tab User::Leave(KErrNotSupported);

\par 

\par \tab TBuf8<20> outputBuffer;

\par \tab TPtrC16 remainderOfUnicodeText(aUnicodeText);

\par \tab FOREVER

\par \tab \tab \{

\par \tab \tab const TInt returnValue=aCharacterSetConverter.ConvertFromUnicode(outputBuffer,

\par \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab remainderOfUnicodeText);

\par \tab \tab if (returnValue==CCnvCharacterSetConverter::EErrorIllFormedInput)

\par \tab \tab \tab User::Leave(KErrCorrupt);

\par \tab \tab else if (returnValue<0) // future-proof against "TError" expanding

\par \tab \tab \tab User::Leave(KErrGeneral);

\par 

\par \tab \tab // ? - do something here with outputBuffer

\par 

\par \tab \tab if (returnValue==0)

\par \tab \tab \tab break; // all of aUnicodeText has been converted and handled

\par \tab \tab remainderOfUnicodeText.Set(remainderOfUnicodeText.Right(returnValue));

\par \tab \tab \}

\par \tab \}

\par }\pard \ltrpar\qj \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

\par An example of how to convert, in small chunks, text in another character set to Unicode:

\par 

\par }\pard \ltrpar\ql \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af2\afs14 \ltrch\fcs0 \f2\fs14\insrsid6646124 LOCAL_C void Co

nvertForeignTextL(CCnvCharacterSetConverter& aCharacterSetConverter,

\par \tab \tab \tab \tab \tab \tab \tab \tab RFs& aFileServerSession,

\par \tab \tab \tab \tab \tab \tab \tab \tab TUint aForeignCharacterSet,

\par \tab \tab \tab \tab \tab \tab \tab \tab const TDesC8& aForeignText)

\par \tab \{

\par \tab if (aCharacterSetConverter.PrepareToConvertToOrFromL(aForeignCharacterSet, aFileServerSession)

\par \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab !=CCnvCharacterSetConverter::EAvailable)

\par \tab \tab User::Leave(KErrNotSupported);

\par 

\par \tab TBuf16<20> outputBuffer;

\par \tab TPtrC8 remainderOfForeignText(aForeignText);

\par \tab // "state" must be initialized to CCnvCharacterSetConverter::KStateDefault - it must not be

\par \tab // tampered with thereafter but simply passed into each call of "ConvertToUnicode"

\par \tab TInt state=CCnvCharacterSetConverter::KStateDefault;

\par \tab FOREVER

\par \tab \tab \{

\par \tab \tab const TInt returnValue=aCharacterSetConverter.ConvertToUnicode(outputBuffer,

\par \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab remainderOfForeignText,

\par \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab state);

\par \tab \tab if (returnValue==CCnvCharacterSetConverter::EErrorIllFormedInput)

\par \tab \tab \tab User::Leave(KErrCorrupt);

\par \tab \tab else if (returnValue<0) // future-proof against "TError" expanding

\par \tab \tab \tab User::Leave(KErrGeneral);

\par 

\par \tab \tab // ? - do something here with outputBuffer

\par 

\par \tab \tab if (returnValue==0)

\par \tab \tab \tab break; // all of aForeignText has been converted and handled

\par \tab \tab remainderOfForeignText.Set(remainderOfForeignText.Right(returnValue));

\par \tab \tab \}

\par \tab \}

\par }\pard \ltrpar\qj \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

\par An example of how to convert, in small chunks, }{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 \i\insrsid6646124 fragmented}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  text in another character set to Unicode:

\par 

\par }\pard \ltrpar\ql \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af2\afs14 \ltrch\fcs0 \f2\fs14\insrsid6646124 

LOCAL_C void ConvertForeignTextL(CCnvCharacterSetConverter& aCharacterSetConverter,

\par \tab \tab \tab \tab \tab \tab \tab \tab RFs& aFileServerSession,

\par \tab \tab \tab \tab \tab \tab \tab \tab TUint aForeignCharacterSet)

\par \tab \{

\par \tab if (aCharacterSetConverter.PrepareToConvertToOrFromL(aForeignCharacterSet, aFileServerSession)

\par \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab !=CCnvCharacterSetConverter::EAvailable)

\par \tab \tab User::Leave(KErrNotSupported);

\par 

\par \tab const TInt KMaximumLengthOfBufferForForeignText=200;

\par \tab TUint8 bufferForForeignText[KMaximumLengthOfBufferForForeignText];

\par \tab TInt lengthOfBufferForForeignText=0;

\par 

\par \tab FOREVER

\par \tab \tab \{

\par \tab \tab TPtr8 nextChunkOfForeignText(bufferForForeignText+lengthOfBufferForForeignText,

\par \tab \tab \tab \tab \tab \tab \tab KMaximumLengthOfBufferForForeignText-lengthOfBufferForForeignText);

\par 

\par \tab \tab // ? load nextChunkOfForeignText here

\par 

\par \tab \tab const TInt lengthOfNextChunkOfForeignText=nextChunkOfForeignText.Length();

\par \tab \tab lengthOfBufferForForeignText+=lengthOfNextChunkOfForeignText;

\par 

\par \tab \tab const TBool isLastChunkOfForeignText= // ? find out from the source of the foreign text

\par \tab \tab // whether this is the last chunk and set this variable accordingly, e.g. the source may

\par \tab \tab // define that the last chunk is of length zero, in which case the expression

\par \tab \tab // "(lengthOfNextChunkOfForeignText==0)" would be assigned to this variable; note that

\par \tab \tab // even if the length of this chunk is zero, we can't just exit this function here as

\par \tab \tab // bufferForForeignText may not be empty (i.e. lengthOfBufferForForeignText>0)

\par 

\par \tab \tab TBuf16<20> outputBuffer;

\par \tab \tab TPtrC8 remainderOfForeignText(bufferForForeignText, lengthOfBufferForForeignText);

\par \tab \tab // "state" must be initialized to CCnvCharacterSetConverter::KStateDefault - it must not

\par \tab \tab // be tampered with thereafter but simply passed into each call of "ConvertToUnicode"

\par \tab \tab TInt state=CCnvCharacterSetConverter::KStateDefault;

\par \tab \tab FOREVER

\par \tab \tab \tab \{

\par \tab \tab \tab const TInt lengthOfRemainderOfForeignText=remainderOfForeignText.Length();

\par \tab \tab \tab if (isLastChunkOfForeignText)

\par \tab \tab \tab \tab \{

\par \tab \tab \tab \tab if (lengthOfRemainderOfForeignText==0)

\par \tab \tab \tab \tab \tab return; // the single point of exit of this function

\par \tab \tab \tab \tab \}

\par \tab \tab \tab else

\par \tab \tab \tab \tab \{

\par \tab \tab \tab \tab // As this isn't the last chunk, we don't want ConvertToUnicode to return

\par \tab \tab \tab \tab // CCnvCharacterSetConverter::EErrorIllFormedInput if the input descriptor ends

\par \tab \tab \tab \tab // with an incomplete sequence - but it will only do this if *none* of the input

\par \tab \tab \tab \tab // descriptor can be consumed. Therefore if the input descriptor is long enough

\par \tab \tab \tab \tab // (20 elements or longer is plenty adequate) there is no danger of this error

\par \tab \tab \tab \tab // being returned for this reason. If it's shorter than that, we'll simply put it

\par \tab \tab \tab \tab // at the start of the buffer so that it gets converted with the next chunk.

\par \tab \tab \tab \tab if (lengthOfRemainderOfForeignText<20)

\par \tab \tab \tab \tab \tab \{

\par \tab \tab \tab \tab \tab // put any remaining foreign text at the start of bufferForForeignText

\par \tab \tab \tab \tab \tab lengthOfBufferForForeignText=lengthOfRemainderOfForeignText;

\par \tab \tab \tab \tab \tab Mem::Copy(bufferForForeignText, remainderOfForeignText.Ptr(),

\par \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab lengthOfBufferForForeignText);

\par \tab \tab \tab \tab \tab break;

\par \tab \tab \tab \tab \tab \}

\par \tab \tab \tab \tab \}

\par 

\par \tab \tab \tab const TInt returnValue=aCharacterSetConverter.ConvertToUnicode(outputBuffer,

\par \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab remainderOfForeignText,

\par \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab \tab state);

\par \tab \tab \tab if (returnValue==CCnvCharacterSetConverter::EErrorIllFormedInput)

\par \tab \tab \tab \tab User::Leave(KErrCorrupt);

\par \tab \tab \tab else if (returnValue<0) // future-proof against "TError" expanding

\par \tab \tab \tab \tab User::Leave(KErrGeneral);

\par 

\par \tab \tab \tab // ? - do something here with outputBuffer

\par 

\par \tab \tab \tab remainderOfForeignText.Set(remainderOfForeignText.Right(returnValue));

\par \tab \tab \tab \}

\par \tab \tab \}

\par \tab \}

\par }\pard\plain \ltrpar\s2\ql \li0\ri0\sb240\sa60\keepn\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\outlinelevel1\rin0\lin0\itap0 \rtlch\fcs1 \ab\ai\af1\afs24\alang1025 \ltrch\fcs0 

\b\i\f1\fs24\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af1 \ltrch\fcs0 \insrsid6646124 Converting text between UCS-2}{\rtlch\fcs1 \af1 \ltrch\fcs0 \cf0\revised\revauth1\revdttm1188449424\insrsid4806205 /}{\rtlch\fcs1 \af1 

\ltrch\fcs0 \cf0\revised\revauth1\revdttm1188404155\insrsid13245431 UTF-16}{\rtlch\fcs1 \af1 \ltrch\fcs0 \insrsid6646124  and Unicode\rquote s transformation formats

\par }\pard\plain \ltrpar\qj \fi720\li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af0 

\ltrch\fcs0 \insrsid6646124 The class }{\rtlch\fcs1 \af2 \ltrch\fcs0 \f2\insrsid6646124 CnvUtfConverter}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  is provided for converting text between UCS-2}{\rtlch\fcs1 \af0 \ltrch\fcs0 

\cf0\revised\revauth1\revdttm1188449425\insrsid4806205  and UTF-7, }{\rtlch\fcs1 \af0 \ltrch\fcs0 \cf0\revised\revauth1\revdttm1188449430\insrsid12266512 as well as }{\rtlch\fcs1 \af0 \ltrch\fcs0 \cf0\revised\revauth1\revdttm1188449425\insrsid4806205 

between }{\rtlch\fcs1 \af0 \ltrch\fcs0 \cf0\revised\revauth1\revdttm1188404160\insrsid13245431 UTF-16}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  and }{\rtlch\fcs1 \af0 \ltrch\fcs0 

\deleted\revauthdel1\revdttmdel1188449425\insrsid6646124\delrsid4806205 the two Unicode transformation formats UTF-7 and }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 UTF-8. (For the definition of these formats, see }{\rtlch\fcs1 \ai\af0 \ltrch\fcs0 

\i\insrsid6646124 The Unicode Standard}{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124  published by The Unicode Consortium.) The public parts of the class are shown below:

\par }\pard \ltrpar\qj \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid6646124 

\par }\pard \ltrpar\ql \li0\ri0\widctlpar\wrapdefault{\*\pn \pnlvlcont\ilvl0\ls0\pnrnot0\pndec }\faauto\rin0\lin0\itap0 {\rtlch\fcs1 \af2\afs14 \ltrch\fcs0 \f2\fs14\insrsid6646124 class CnvUtfConverter

\par \tab \{

\par public:

\par \tab enum TError

\par \tab \tab \{

\par \tab \tab EErrorIllFormedInput=-1

\par \tab \tab \};

\par \tab enum \{KStateDefault=0\};

\par public:

\par \tab IMPORT_C static TInt ConvertFromUnicodeToUtf7(TDes8&, const TDesC16&, TBool);