// Copyright (c) 2004-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 __TZLOCAL_DATATYPES_H__

 #define __TZLOCAL_DATATYPES_H__

 #include <e32base.h>	//CBase

 /**

 Encapsulates the correspondence between a time zone ID and a resource ID and

 facilitates fast finding of resources in the resource file.  For internal use only.

 @internalTechnology

 */

 class TTzLocalizedId

 	{

 	public:

 		// Represents an invalid UTC offset of 25 hours and 1 minutes, in minutes

 		enum TTzUTCOffset

 			{

 			ETzInvalidUTCOffset = 1501

 			};

 	public:

 		TTzLocalizedId(const TUint16 aTzId, const TUint aResourceId =0);

 		//Accessor methods

 		inline TUint16 TimeZoneId() const;

 		inline TUint ResourceId() const;

 		inline TInt UTCOffset() const;

 		inline void SetUTCOffset(TInt aOffsetInMinutes);

 	private:

 		TUint16 iTzId;

 		TUint iResourceId;

 		TInt iUTCOffset;	//UTC offset stored in minutes

 	};

 /**

 Encapsulates a localized (exemplar) city.

 @publishedAll

 @released

 */

 class CTzLocalizedCity : public CBase

 	{

 	public:

 		static CTzLocalizedCity* NewL(

 			const TDesC& aName,

 			const TTzLocalizedId& aTzLocalizedId,

 			const TUint8 aGroupId =0);

 		static CTzLocalizedCity* NewLC(

 			const TDesC& aName,

 			const TTzLocalizedId& aTzLocalizedId,

 			const TUint8 aGroupId =0);

 		~CTzLocalizedCity();

 		//Accessor methods

 		IMPORT_C TPtrC Name() const;

 		IMPORT_C TUint16 TimeZoneId() const;

 		IMPORT_C TUint8 GroupId() const;

 		TTzLocalizedId TzLocalizedId() const;

 		TInt UTCOffset() const;

 		void SetUTCOffset(TInt aUTCoffset);

         void SetCityIndex(TInt aIndex);

        	TInt CityIndex() const;

 	private:

 		void ConstructL(const TDesC& aName);

 		CTzLocalizedCity(const TUint8 aGroupId, const TTzLocalizedId& aTzLocalizedId);

 	private:

 		//Member data

 		HBufC* iName;

 		TUint8 iGroupId;

 		TTzLocalizedId iTzLocalizedId;

         TInt iCityIndex;

 	};

 /**

 Encapsulates a localized group of (exemplar) cities.

 @publishedAll

 @released

 */

 class CTzLocalizedCityGroup : public CBase

 	{

 	public:

 		static CTzLocalizedCityGroup* NewL(const TDesC& aName, const TUint8 aGroupId);

 		static CTzLocalizedCityGroup* NewLC(const TDesC& aName, const TUint8 aGroupId);

 		~CTzLocalizedCityGroup();

 		//Accessor methods

 		IMPORT_C TPtrC Name() const;

 		IMPORT_C TUint8 Id() const;

 	private:

 		void ConstructL(const TDesC& aName);

 		CTzLocalizedCityGroup(const TUint8 aGroupId);

 	private:

 		//Member data

 		HBufC* iName;

 		TUint8 iGroupId;

 	};

 /**

 Encapsulates a group of LDML localized timezone names.

 LDML stands for Locale Data Markup Language. For details, see 

 http://www.openi18n.org/specs/ldml/1.0/ldml-spec.htm.

 @publishedAll

 @released

 */

 class CTzLocalizedTimeZone : public CBase

 	{

 	public: //enums

 		/**

 		Flags to identify a cached zone.

 		@publishedAll

 		@released

 		*/

 		enum TTzFrequentlyUsedZone

 			{

 			/** The current zone. */

 			ECurrentZone,

 			/** The home zone. */

 			EHomeZone,

 			/** The zone of interest. */

 			EInterestZone,

 			/** The first recently-used zone. */

 			ERecentZone1,

 			/** The second recently-used zone. */

 			ERecentZone2,

 			/** Specifies the number of cached zones. Not to be used as an API argument. */

 			ECachedTimeZones	// If new items are added to this enum, this must 

 								// left as last item, because it is used to keep 

 								// count of the number of cached zones

 			};

 	public:

 		static CTzLocalizedTimeZone* NewL(

 			const TTzLocalizedId& aTzLocalizedId,

 			const TDesC& aStandardName,

 			const TDesC& aDaylightName,

 			const TDesC& aShortStandardName,

 			const TDesC& aShortDaylightName);

 		static CTzLocalizedTimeZone* NewLC(

 			const TTzLocalizedId& aTzLocalizedId,

 			const TDesC& aStandardName,

 			const TDesC& aDaylightName,

 			const TDesC& aShortStandardName,

 			const TDesC& aShortDaylightName);

 		~CTzLocalizedTimeZone();

 		//Accessor methods

 		IMPORT_C TUint16 TimeZoneId() const;

 		IMPORT_C TPtrC StandardName() const;

 		IMPORT_C TPtrC DaylightName() const;

 		IMPORT_C TPtrC ShortStandardName() const;

 		IMPORT_C TPtrC ShortDaylightName() const;

 		TTzLocalizedId TzLocalizedId() const;

 		TInt UTCOffset() const;

 		void SetUTCOffset(TInt aUTCoffset);

 	private:

 		void ConstructL(

 			const TDesC& aStandardName,

 			const TDesC& aDaylightName,

 			const TDesC& aShortStandardName,

 			const TDesC& aShortDaylightName);

 		CTzLocalizedTimeZone(const TTzLocalizedId& aTzLocalizedId);

 	private:

 		//Member data

 		TTzLocalizedId iTzLocalizedId;

 		HBufC* iStandardName;

 		HBufC* iDaylightName;

 		HBufC* iShortStandardName;

 		HBufC* iShortDaylightName;

 	};

 /**

 Template for arrays of localized objects. Implemented using a thin template. 

 All functions are inline.

 @publishedAll

 @released

 */

 template <class T>

 class CTzLocalizedArray : public CBase

 	{

 	protected:

 		inline ~CTzLocalizedArray();

 		inline T& At(TInt aIndex) const;

 		inline TInt Count() const;

 		inline void AppendL(T* aElement);

 		inline void Remove(TInt aIndex);

 		inline void Sort(TLinearOrder<T> aOrder);

 		inline TInt Find(T* aEntry,TIdentityRelation<T> aIdentityRelation);

 		inline CTzLocalizedArray();

 	private:

 		//Member data

 		RPointerArray<T> iArray;

 	};

 // Assign concrete classes for each of the arrays that will be used

 // This guards against future BC problems

 /**

 An array of cities. This just passes function calls on to its templated base

 class, CTzLocalizedArray.

 @publishedAll

 @released

 */

 class CTzLocalizedCityArray : public CTzLocalizedArray<CTzLocalizedCity>

 	{

 	public:

 		IMPORT_C static CTzLocalizedCityArray* NewL();

 		IMPORT_C static CTzLocalizedCityArray* NewLC();

 		IMPORT_C CTzLocalizedCity& At(TInt aIndex) const;

 		IMPORT_C TInt Count() const;

 		IMPORT_C void AppendL(CTzLocalizedCity* aCity);

 		IMPORT_C void Remove(TInt aIndex);

 		IMPORT_C void Sort(TLinearOrder<CTzLocalizedCity> anOrder);

 		IMPORT_C TInt Find(CTzLocalizedCity* anEntry,TIdentityRelation<CTzLocalizedCity> aIdentityRelation);

 	};

 /**

 An array of city groups. This just passes function calls on to its templated base

 class, CTzLocalizedArray.

 @publishedAll

 @released

 */

 class CTzLocalizedCityGroupArray : public CTzLocalizedArray<CTzLocalizedCityGroup>

 	{

 	public:

 		IMPORT_C static CTzLocalizedCityGroupArray* NewL();

 		IMPORT_C static CTzLocalizedCityGroupArray* NewLC();

 		IMPORT_C CTzLocalizedCityGroup& At(TInt aIndex) const;

 		IMPORT_C TInt Count() const;

 		IMPORT_C void AppendL(CTzLocalizedCityGroup* aGroup);

 		IMPORT_C void Remove(TInt aIndex);

 		IMPORT_C void Sort(TLinearOrder<CTzLocalizedCityGroup> anOrder);

 		IMPORT_C TInt Find(CTzLocalizedCityGroup* anEntry,TIdentityRelation<CTzLocalizedCityGroup> aIdentityRelation);

 	};

 /**

 An array of time zones. This just passes function calls on to its templated base

 class, CTzLocalizedArray.

 @publishedAll

 @released

 */

 class CTzLocalizedTimeZoneArray : public CTzLocalizedArray<CTzLocalizedTimeZone>

 	{

 	public:

 		IMPORT_C static CTzLocalizedTimeZoneArray* NewL();

 		IMPORT_C static CTzLocalizedTimeZoneArray* NewLC();

 		IMPORT_C CTzLocalizedTimeZone& At(TInt aIndex) const;

 		IMPORT_C TInt Count() const;

 		IMPORT_C void AppendL(CTzLocalizedTimeZone* aElement);

 		IMPORT_C void Remove(TInt aIndex);

 		IMPORT_C void Sort(TLinearOrder<CTzLocalizedTimeZone> anOrder);

 		IMPORT_C TInt Find(CTzLocalizedTimeZone* anEntry,TIdentityRelation<CTzLocalizedTimeZone> aIdentityRelation);

 	};

 #include <tzlocalizationdatatypes.inl>

 #endif //__TZLOCAL_DATATYPES_H__

 //==================================================================

 // End of file

 //==================================================================