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

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

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

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

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

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

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

...

CharacterSet 0x10004cc6

    StandardName    "US-ASCII"

    StandardName    "ASCII"

    StandardName    "ANSI_X3.4-1968"

    StandardName    "iso-ir-6"

    StandardName    "ANSI_X3.4-1986"

    StandardName    "ISO_646.irv:1991"

    StandardName    "ISO646-US"

    StandardName    "us"

    StandardName    "IBM367"

    StandardName    "cp367"

    StandardName    "csASCII"

    MibEnum            3

CharacterSet 0x10003b10

    StandardName    "ISO-8859-1"

    StandardName    "ISO_8859-1"

    StandardName    "latin1"

    StandardName    "iso-ir-100"

    StandardName    "l1"

    StandardName    "IBM819"

    StandardName    "CP819"

    StandardName    "csISOLatin1"

    MibEnum            4

...

</codeblock> </li> <li id="GUID-65593A6B-21F3-5416-AE81-7D81AB771C95"><p>Use the <codeph>snmtool</codeph> to generate an SNM file from the source SNM file. </p> <p>From a command line, run the following commands to go to the Symbian tools directory and execute <codeph>snmtool</codeph>: </p> <p><userinput>cd d:\Symbian\epoc32\tools</userinput> </p> <p><userinput>snmtool.bat d:\charconvfiles\basicsnm.txt d:\charconvfiles\basic.snm</userinput> </p> </li> <li id="GUID-29001446-1A91-5694-886C-EA57AFEE51EC"><p>Copy the SNM file to the <filepath>\system\charconv\</filepath> directory. </p> </li> </ol> <p> <b>Retrieving a Character Converter UID using an SNM standard name or MIB enum</b>  </p> <ol id="GUID-7A861BDF-B0E8-53F8-B14F-5E69477F79E3"><li id="GUID-0A625B0A-6D8A-5D20-9DB6-E88B7CA83B86"><p>Use an SNM standard name or MIB enum value to retrieve the UID of the character converter. </p> <codeblock id="GUID-A1A41057-D50A-50A5-955E-C59B9B739A5B" xml:space="preserve">RFs fileServerSession;

CCnvCharacterSetConverter* characterSetConverter = CCnvCharacterSetConverter::NewLC();

TUint characterSetUid = 

    characterSetConverter->ConvertStandardNameOfCharacterSetToIdentifierL(_L8("ASCII"), fileServerSession);

    // use the UID to load the converter.

CCnvCharacterSetConverter::TAvailability available = 

    characterSetConverter->PrepareToConvertToOrFromL(characterSetUid, fileServerSession);

...</codeblock> </li> </ol> <p>There are two functions for getting a UID: </p> <ul><li id="GUID-B5DC4C12-C0F6-5A66-B4EA-68A154F777FA"><p> <codeph>CCnvCharacterSetConverter::ConvertStandardNameOfCharacterSetToIdentifierL()</codeph> takes a standard name as a parameter. </p> </li> <li id="GUID-E0F345C4-22D9-5090-B4C2-97071EBBB49A"><p> <codeph>CCnvCharacterSetConverter::ConvertMibEnumOfCharacterSetToIdentifierL()</codeph> takes a MIB enum value as a parameter. </p> </li> </ul> <p>These functions read the SNM file to get the UID. The UID can then be passed to <codeph>PrepareToConvertToOrFromL()</codeph> to load the right converter. </p> <p> <b>Note</b>: If there are multiple SNM files, the contents are combined. </p> </section> </conbody></concept>