1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-C71311A7-F747-57EB-B31F-6E634D5976A3" xml:lang="en"><title> Character

    13 Conversion (Charconv) Framework Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>The Symbian platform uses UTF-16 encoded Unicode text. The Charconv Framework

    15 provides the APIs and <xref href="GUID-06EDE5E8-04EA-5A74-ADE2-E5B8C49AB292.dita#GUID-06EDE5E8-04EA-5A74-ADE2-E5B8C49AB292/GUID-5E593C5A-882B-5B11-AD6E-CFD10EA6700B">converters</xref> to

    16 convert characters between foreign encodings and Unicode (UTF-16). </p>

    17 <p> </p>

    18 <section><title>Architecture</title> <p>The Character Conversion Framework

    19 comprises two components: </p> <ul>

    20 <li id="GUID-BD14B058-9F17-5B43-B3B4-12298700A6C2"><p>The Character Encoding

    21 and Conversion Framework component is also referred to as Charconv Framework.

    22 It contains built-in converters for many languages. It also provides APIs

    23 for selecting built-in or plug-in converters. </p> </li>

    24 <li id="GUID-91F95B05-7345-5617-81C0-1FF02119CC04"><p>The Character Encoding

    25 and Conversion Plug-ins component, also referred to as Charconv Plug-ins,

    26 contains ECom <xref href="GUID-001F6216-48AE-57D4-8985-65CF77B26F19.dita#GUID-001F6216-48AE-57D4-8985-65CF77B26F19/GUID-74C42671-A14C-5E38-8618-06CD8AFB5C70">plug-in

    27 converters</xref> for various languages not supported by the built-in converters.

    28 Device creators can write additional plug-in converters by implementing the <codeph>CCharacterSetConverterPluginInterface</codeph> interface. </p> </li>

    29 </ul> <fig id="GUID-4B8A7DE4-6A72-5950-96CE-D8BEACD977A0">

    30 <title>              Charconv Framework collection            </title>

    31 <image href="GUID-F681C857-086F-527A-9946-A91560601658_d0e377073_href.jpg" placement="inline"/>

    32 </fig> <p> </p> </section>

    33 <section><title>Using the Character Conversion Framework </title> <p>Application

    34 developers can use the Charconv API to convert text between various encodings

    35 and Unicode. </p> <p>Device creators can also write additional

    36 plug-in converters for specific encodings. </p> </section>

    37 </conbody><related-links>

    38 <link href="GUID-06EDE5E8-04EA-5A74-ADE2-E5B8C49AB292.dita"><linktext>Character

    39 Conversion (Charconv) Framework Concepts</linktext></link>

    40 <link href="GUID-E64C06D7-B138-5BCC-A814-3F9E2C517404.dita"><linktext>Character

    41 Encoding and Conversion Framework Component</linktext></link>

    42 <link href="GUID-E7ACEC20-27C9-5124-A46E-2812A64E3E4B.dita"><linktext>Character

    43 Encoding and Conversion Plug-ins Component</linktext></link>

    44 </related-links></concept>