#if !defined(__CHARCONV_H__)

#define __CHARCONV_H__

#if !defined(__E32STD_H__)

#include <e32std.h>

#endif

#if !defined(__E32BASE_H__)

#include <e32base.h>

#endif

/** 

The maximum length in bytes of the replacement text for unconvertible Unicode 

characters (=50) (see CCnvCharacterSetConverter::SetReplacementForUnconvertibleUnicodeCharactersL()). 

@publishedAll

@released

*/

const TInt KMaximumLengthOfReplacementForUnconvertibleUnicodeCharacters=50;

/** 

UTF-7 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierUtf7=0x1000582c;

/** 

UTF-8 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierUtf8=0x1000582d;

/** 

IMAP UTF-7 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierImapUtf7=0x1000582e;

/** 

Java UTF-8 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierJavaConformantUtf8=0x1000582f;

/** 

Code Page 1252 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierCodePage1252=0x100012b6;

/** 

ISO 8859-1 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso88591=0x10003b10;

/** 

ISO 8859-2 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso88592=0x1000507e;

/** 

ISO 8859-3 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso88593=0x10008a28;

/** 

ISO 8859-4 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso88594=0x1000507f;

/** 

ISO 8859-5 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso88595=0x10005080;

/** 

ISO 8859-6 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso88596=0x10008a29;

/** 

ISO 8859-7 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso88597=0x10005081;

/** 

ISO 8859-8 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso88598=0x10008a2a;

/** 

ISO 8859-9 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso88599=0x10005082;

/** 

ISO 8859-10 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso885910=0x10008a2b;

/** 

ISO 8859-13 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso885913=0x10008a2c;

/** 

ISO 8859-14 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso885914=0x10008a2d;

/** 

ISO 8859-15 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso885915=0x10008a2e;

/** 

ASCII 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierAscii=0x10004cc6;

/** 

SMS 7-bit 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierSms7Bit=0x100053ab;

/** 

GB 2312 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierGb2312=0x10000fbe;

/** 

HZ-GB-2312 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierHz=0x10006065;

/** 

GB 12345 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierGb12345=0x1000401a;

/** 

GBK 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierGbk=0x10003ecb;

/** 

Big 5 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierBig5=0x10000fbf;

/** 

Shift-JIS 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierShiftJis=0x10000fbd;

/** 

ISO-2022-JP 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso2022Jp=0x100066a0;

/** 

ISO-2022-JP-1 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierIso2022Jp1=0x100066a3;

/** 

JIS Encoding 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierJis=0x10006066;

/** 

EUC-JP 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierEucJpPacked=0x10006067;

/** 

JP5 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierJ5=0x1020D408;

/** 

CP850 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierCP850=0x102825AD;

const TUint KCharacterSetIdentifierUnicodeLittle=0x101f3fae;  //Little Endian Unicode

const TUint KCharacterSetIdentifierUnicodeBig=0x101f4052; // Big Endian Unicode 

/** 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierExtendedSms7Bit=0x102863FD;

/** 

Turkish 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierTurkishSingleSms7Bit=0x102863FE;

const TUint KCharacterSetIdentifierTurkishLockingSms7Bit=0x102863FF;

const TUint KCharacterSetIdentifierTurkishLockingAndSingleSms7Bit=0x10286400;

/** 

Portuguese 

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierPortugueseSingleSms7Bit=0x10286407;

const TUint KCharacterSetIdentifierPortugueseLockingSms7Bit=0x10286408;

const TUint KCharacterSetIdentifierPortugueseLockingAndSingleSms7Bit=0x10286409;

/** 

Spanish

@publishedAll

@released

*/

const TUint KCharacterSetIdentifierSpanishSingleSms7Bit=0x1028640A;

// note that other character sets than those listed above may be available at run-time, and also that none of the above are necessarily available at run-time

struct SCnvConversionData;

class CDeepDestructingArrayOfCharactersSets;

class CFileReader;

class CStandardNamesAndMibEnums;

class RFs;

class CCharsetCnvCache;

/** 

Converts text between Unicode and other character sets. 

The first stage of the conversion is to specify the non-Unicode character 

set being converted to or from. This is done by calling one of the overloads 

of PrepareToConvertToOrFromL().

The second stage is to convert the text, using one of the overloads of 

ConvertFromUnicode() or ConvertToUnicode().

Where possible the first documented overload of PrepareToConvertToOrFromL() 

should be used because the second overload panics if the specified character 

set is not available: the first overload simply returns whether the character 

set is available or not available. However if the conversions are to be 

performed often, or if the user must select the character set for the 

conversion from a list, the second overload may be more appropriate.

The first overload is less efficient than the second, because it searches 

through the file system for the selected character set every time it is invoked. 

The second overload searches through an array of all available character sets. 

In this method, the file system need only be searched once - when 

CreateArrayOfCharacterSetsAvailableLC() or 

CreateArrayOfCharacterSetsAvailableL() is used to create the array.

The conversion functions allow users of this class to perform partial 

conversions on an input descriptor, handling the situation where the input 

descriptor is truncated mid way through a multi-byte character. This means 

that you do not have to guess how big to make the output descriptor for a 

given input descriptor, you can simply do the conversion in a loop using a 

small output descriptor. The ability to handle truncated descriptors also 

allows users of the class to convert information received in chunks from an 

external source.

The class also provides a number of utility functions. 

@publishedAll

@released

*/

class CCnvCharacterSetConverter : public CBase

	{

public:

	for conversion. Used by the second overload of 

	PrepareToConvertToOrFromL(). */

	enum TAvailability

		{

		/** The requested character set can be converted. */

		EAvailable,

		/** The requested character set cannot be converted. */

		ENotAvailable

		};

	/** Conversion error flags. At this stage there is only one error 

	flag- others may be added in the future. */

	enum TError

		{

		/** The input descriptor contains a single corrupt character. This 

		might occur when the input descriptor only contains some of the bytes 

		of a single multi-byte character. */

		EErrorIllFormedInput=KErrCorrupt

		};

	/** Specifies the default endian-ness of the current character set. 

	Used by SetDefaultEndiannessOfForeignCharacters(). */

	enum TEndianness

		{

		/** The character set is big-endian. */

		ELittleEndian,

		/** The character set is little-endian. */

		EBigEndian

		};

	/** Downgrade for line and paragraph separators */

	enum TDowngradeForExoticLineTerminatingCharacters

		{

		/** Paragraph/line separators should be downgraded (if necessary) 

		into carriage return and line feed pairs. */

		EDowngradeExoticLineTerminatingCharactersToCarriageReturnLineFeed,

		/** Paragraph/line separators should be downgraded (if necessary) 

		into a line feed only. */