// Copyright (c) 2003-2009 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 "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
// which accompanies this distribution, and is available
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
//

#ifndef __CHARSETCONVERTER_H__
#define __CHARSETCONVERTER_H__

#include <f32file.h>

class CCnvCharacterSetConverter;

namespace Xml
{

/**
The CCharSetConverter class supplies algorithms for character conversion
between a chosen character set and unicode. Memory management
needed to hold the converted data is also handled.

@see CCnvCharacterSetConverter
@see CnvUtfConverter
@see MParser

@publishedPartner
@released
*/
class CCharSetConverter : public CBase
	{
public:

	static CCharSetConverter* NewL();
	virtual ~CCharSetConverter();

	IMPORT_C void PrepareCharConvL(TUint& aCharSetUid, const TDesC8& aEncoding);
	IMPORT_C void PrepareCharConvL(TUint& aCharSetUid, TInt aMibEnum);

	IMPORT_C TInt ConvertToUnicodeL(TUint32 aSrcCharset, const TDesC8& aInputBuffer, 
		                            HBufC16*& aUnicodeConversion);
	IMPORT_C TInt ConvertFromUnicodeL(const TDesC16& aUnicodeConversion, TUint32 aDestCharset, 
		                              HBufC8*& aOutputBuffer);
	IMPORT_C void PrepareToConvertToOrFromL(TUint32 aCharSetUid);
	IMPORT_C TInt ConvertUcs4CharactersToEncodingL(TUint32* aUcs4Src, TInt aUcs4Count, 
		                                           TUint32 aDestCharset, HBufC8*& aConversion);
	IMPORT_C void ConvertCharacterSetIdentifierToStandardNameL(TUint32 aCharSetUid, HBufC8*& aCharSet);
	
	IMPORT_C TInt ConvertToUnicodeL(TUint32 aSrcCharset, const TDesC8& aInputBuffer, TPtr16& aOutput);
	IMPORT_C TInt ConvertFromUnicodeL(const TDesC16& aUnicodeConversion, TUint32 aDestCharset, TPtr8& aOutput);
		
private:

	CCharSetConverter();
	CCharSetConverter(const CCharSetConverter& aOriginal);
	CCharSetConverter& operator=(const CCharSetConverter& aRhs);
	
	void ConstructL();

	TText16* Utf32ToUtf16(TText16* aUtf16Out, TUint32 aUtf32);

private:

/**
The CharConv instance that we use to help in the character conversions.
*/
	CCnvCharacterSetConverter* iCnvCharacterSetConverter;

/**
The File Server session handle.
*/
	RFs iFs;
	
/**	
The buffer used to store the unicode conversion output.
*/
	TAny* iConversionBuffer;

/**	
The size of the unicode conversion buffer.
*/
	TUint32 iConversionBufferSize;
	};
}


#endif //__CHARSETCONVERTER_H__
