// Copyright (c) 1999-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 __SMUT_H__

 #define __SMUT_H__

 #include <msvstd.h>

 #include <msvids.h>

 #include <barsc.h>

 class CSmsMessage;

 class CContactItemField;

 class TResourceReader;

 class CMsvSession;

 class CMsvServerEntry;

 class CMsvEntry;

 class CSmsSettings;

 /**

 The SMS MTM UID.

 Used to identify the MTMs used for handling SMS messages.

 @publishedAll

 @released

 */

 const TUid KUidMsgTypeSMS			= {0x1000102C};

 /**

 The default maximum length used when extracting a description for an SMS message.

 Used as default value of aMaxLength in TSmsUtilities::GetDescription. This

 function is used to extract a string to used as a suitable description field in

 the message index for a particular SMS message.

 The CSmsSettings provides accessors to get and set the preferred maximum

 description length.

 @deprecated

 This should not really be used outside of the SMS client MTM. The value provided

 by the CSmsSettings class should be used.

 @see	CSmsSettings::GetDescriptionLength

 */

 const TInt KSmsDescriptionLength	= 32;

 /**

 The default maximum length used when extracting the sender/recipiant details for

 an SMS message.

 Used as default value of aMaxLength in TSmsUtilities::GetDetails. This function

 is used to extract a string to used as the details field in the message index

 for a particular SMS message.

 @deprecated

 This should really be used at all.

 */

 const TInt KSmsDetailsLength		= 32;

 _LIT(KSmsResourceFile, "\\resource\\messaging\\SMSS.RSC");

 /**

 SMS Messaging utility functions.

 @publishedAll

 @released

 */

 class TSmsUtilities

 	{

 public:

 /**

 Special SMS Message Indication Type.

 A special SMS message indication is used to notify of waiting services, for

 instance a voicemail message.

 The TSmsUtilitiesSpecialMessageType enum represents the flags for the known

 indication types.

 */

 	enum TSmsUtilitiesSpecialMessageType

 		{

 /**

 Voice message waiting.

 */

 		EVoiceMessageWaiting = 0,

 /**

 Fax message waiting.

 */

 		EFaxMessageWaiting,

 /**

 E-mail message waiting.

 */

 		EEmailMessageWaiting,

 /**

 Other message-type waiting (see 3GPP TS 23.038 [9] for definition of "other").

 */

 		EOtherMessageWaiting,

 /**

 Mask used to obtain the mesasge indication type from the SMS data.

 */

 		ESpecialMessageTypeMask = 0x7F

 		};

 	/**

 	@internalComponent

 	@removed

 	*/

 	IMPORT_C void Dummy_Export_1();

 	/**

 	@internalComponent

 	@removed

 	*/

 	IMPORT_C void Dummy_Export_2();

 	IMPORT_C static void ServiceIdL(CMsvServerEntry& aEntry, TMsvId& aFirstId, TUid aMtm = KUidMsgTypeSMS, CMsvEntrySelection* aServiceIds = NULL);

 	IMPORT_C static void ServiceIdL(CMsvEntry& aEntry, TMsvId& aFirstId, TUid aMtm = KUidMsgTypeSMS, CMsvEntrySelection* aServiceIds = NULL);

 	IMPORT_C static void ServiceIdL(CMsvSession& aSession, TMsvId& aFirstId, TUid aMtm = KUidMsgTypeSMS, CMsvEntrySelection* aServiceIds = NULL); //more efficient version of the previous one

 	IMPORT_C static void PopulateMsgEntry(TMsvEntry& aEntry, const CSmsMessage& aMessage, TMsvId aServiceId, TUid aMtm = KUidMsgTypeSMS);

 	IMPORT_C static void PopulateMsgEntry(TMsvEntry& aEntry, const CSmsMessage& aMessage, TMsvId aServiceId, const CSmsSettings& aSettings, TUid aMtm = KUidMsgTypeSMS);

 	IMPORT_C static TInt GetDetails(RFs& aFs, const CSmsMessage& aMessage, TDes& aDetails, TInt aMaxLength = KSmsDetailsLength);

 	IMPORT_C static TInt GetDetails(RFs& aFs, const TDesC& aFromAddress, TDes& aDetails, TInt aMaxLength = KSmsDetailsLength);

 	IMPORT_C static TInt GetDescription(const CSmsMessage& aMessage, TDes& aDescription, TInt aMaxLength = KSmsDescriptionLength);

 	IMPORT_C static RResourceFile OpenResourceFileL(RFs& aFs);

 	IMPORT_C static void ReadResourceStringL(RResourceFile aResourceFile, TInt aResourceId, TDes& aString);

 private:

 	static void CompareEntryL(const TMsvEntry& aEntry, TUid aMtm, TMsvId& aFirstId, CMsvEntrySelection* aServiceIds);

 	static void GetName(CContactItemField& aField, TUid aFieldType, TDes& aName);

 	static void DoGetDetailsL(RFs& aFs, const TDesC& aFromAddress, TDes& aDetails, TInt aMaxLength);

 	static void Replace(const TDesC& aOld, const TDesC& aNew, TDes& aString);

 	static TBool DoGetDescriptionL(const CSmsMessage& aMessage, TDes& aDescription, TInt aMaxLength);

 	static void ExtractDescriptionFromMessage(const CSmsMessage& aMessage, TDes& aDescription, TInt aMaxLength);

 	static TBool ValidGsmNumber(const TDesC& aTelephone);

 	};

 #endif	// __SMUT_H__