// Copyright (c) 1997-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 __VUTIL_H__

#define __VUTIL_H__

// System includes

#ifndef __E32BASE_H__

#include <e32base.h>

#endif

#ifndef __F32FILE_H__

#include <f32file.h>

#endif

#ifndef __CHARCONV_H__

#include <charconv.h>

#endif

class Versit

/** Provides Versit-specific encoding and character set identifiers. 

@publishedAll

@released

*/

	{

public:

	/** Versit-specific encoding identifiers. 

	@publishedAll

	@released

	*/

	enum TVersitEncoding

		{

		/** No encoding. */

		ENoEncoding,

		/** Quoted Printable encoding. */

		EQuotedPrintableEncoding,

		/** Base 64 encoding. */

		EBase64Encoding,

		// Used internally - not to be used by versit clients

		/** Eight bit encoding. */

		EEightBitEncoding

		};

	/** Versit-specific character set identifiers. These are used in the Versit API 

	to represent foreign (non-Unicode) character sets for vCard and vCalendar 

	properties. 

	@publishedAll

	@released */

	enum TVersitCharSet

		{

		/** Unknown character set. */

		EUnknownCharSet,

		/** ASCII (7-bit).*/

		EUSAsciiCharSet,	

		/** UTF-8 Unicode transformation format. */

		EUTF8CharSet,

		/** UTF-7 Unicode transformation format. */

		EUTF7CharSet,

		/** ISO 8859-1 (8-bit). */

		EISO88591CharSet,

		/** ISO 8859-2 (8-bit). */

		EISO88592CharSet,

		/** ISO 8859-4 (8-bit). */

		EISO88594CharSet,

		/** ISO 8859-5 (8-bit). */

		EISO88595CharSet,

		/** ISO 8859-7 (8-bit). */

		EISO88597CharSet,

		/** ISO 8859-9 (8-bit). */

		EISO88599CharSet,

		/** ISO 8859-3 (8-bit). */

		EISO88593CharSet,

		/** ISO 8859-10 (8-bit). */

		EISO885910CharSet,

		/** GB 2312. */

		EGB231280CharSet,

		/** GBK. */

		EGBKCharSet,

		/** Big 5. */

		EBIG5CharSet,

		/** ISO-2022-JP. */

		EISO2022JPCharSet,

		/** EUC-JP. */

		EEUCJPCharSet,

		/** Shift JIS. */

		EShiftJISCharSet,

		/** JIS. */

		EJISCharSet,

		/** Must be first character set. */

		EFirstCharSet=EUSAsciiCharSet,

		/** Must be last character set. */

		ELastCharSet=EJISCharSet

		};

	class TEncodingAndCharset

	/** Specifies an encoding, a character set and a character set converter. 

	@publishedAll

	@released */

		{

	public:

		inline TEncodingAndCharset(TVersitEncoding aEncoding,TUint aCharSetId) :iEncoding(aEncoding), iCharSetId(aCharSetId) 

		/** The C++ constructor initialises the encoding and character set.

		@param aEncoding An encoding.

		@param aCharSetId A character set. */

			{}

	public:

		/** An encoding. */

		TVersitEncoding iEncoding;

		/** A character set. */

		TUint iCharSetId;

		/** A character set converter. */

		CCnvCharacterSetConverter* iConverter;

		};

	};

class CVersitUnicodeUtils : public CBase

/** Versit Unicode utilities class. 

This enables conversion between Unicode and ISO character sets. 

@publishedAll

@released

*/

	{

public:

	IMPORT_C ~CVersitUnicodeUtils();

	IMPORT_C HBufC8* NarrowL(const TDesC& aDesC);

	IMPORT_C HBufC8* NarrowLC(const TDesC& aDesC);

	IMPORT_C HBufC* WidenL(const TDesC8& aDesC8);

	IMPORT_C HBufC* WidenLC(const TDesC8& aDesC8);

	IMPORT_C void CreateConverterL();

	CCnvCharacterSetConverter::TAvailability SetCurrentCharSetL(TUint aCharacterSet);

public:

	inline CCnvCharacterSetConverter& CharacterSetConverter() const;

	inline TUint ConvertStandardNameL(const TDesC8& aStandardNameOfCharacterSet);

	inline HBufC8* StandardNameL(TUint aCharSetId);

	TUint AutoDetectCharSetL(const TDesC8& aSample,const CArrayFix<CCnvCharacterSetConverter::SCharacterSet>* aAutoDetectCharSets);

private:

	RFs iFsSession;

	CCnvCharacterSetConverter* iUnicodeConverter;

	TBool iFsConnected;

	TUint iCurrentConverterCharSet;

	CArrayFix<CCnvCharacterSetConverter::SCharacterSet>* iCharSetsAvailable;

	};

inline CCnvCharacterSetConverter& CVersitUnicodeUtils::CharacterSetConverter() const

/** Returns the character set converter created in CreateConverterL().

@return A character set converter. */

	{

	return *iUnicodeConverter;

	}

inline TUint CVersitUnicodeUtils::ConvertStandardNameL(const TDesC8& aStandardNameOfCharacterSet)

/** Returns the Symbian OS UID for a character set from its Internet-standard 

name.

@param aStandardNameOfCharacterSet Internet-standard name of a character set 

encoded in 8-bit ASCII.

@return The Symbian OS UID of the specified character set. If the name is not 

known, zero is returned. */

	{

	return iUnicodeConverter->ConvertStandardNameOfCharacterSetToIdentifierL(aStandardNameOfCharacterSet,iFsSession);

	}

inline HBufC8* CVersitUnicodeUtils::StandardNameL(TUint aCharSetId)

/** Returns the Internet-standard name of a character set, from its Symbian OS UID. 

@param aCharSetId The Symbian OS UID of a character set.

@return The Internet-standard name or MIME name of the specified character 

set, or NULL if the UID is not known. The name is encoded in 8-bit ASCII. */

	{

	return iUnicodeConverter->ConvertCharacterSetIdentifierToStandardNameL(aCharSetId,iFsSession);

	}

#endif