/*

* 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 "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description: 

* As specified in SGL.GT0188.251

*

*/

/**

 @file 

 @publishedPartner

 @released

*/

#ifndef __SISSTRING_H__

#define __SISSTRING_H__

#include "field.h"

class CSISString : public CSISField <CSISFieldRoot::ESISString>

	{

public:

	/**

	 * Default constructor

	 */

	CSISString ();

	/**

	 * Creates an instance of the class from wstring objec.

	 */

	CSISString (const std::wstring& aValue);

	/**

	 * Creates an instance of this class.

	 * @param aRequired false if the object is optional else true.

	 */

	CSISString (const bool aRequired);

	/**

	 * Creates an instance of the class from wstring objec.

	 * @param aRequired false if the object is optional else true.

	 */

	CSISString (const std::wstring initialValue, const bool aRequired);

	/**

	 * Copy constructor.

	 */

	CSISString (const CSISString& aString);

	/**

	 * Internalize the class.

	 * @param aFile Stream from which the content should be read.

	 * @param aContainerSize Size of the content to be read.

	 * @param aArrayType type of the structure.

	 */

	virtual void Read (TSISStream& aFile, const TFieldSize& aContainerSize, const CSISFieldRoot::TFieldType aArrayType = CSISFieldRoot::ESISUndefined);

	/**

	 * Externalize the class.

	 * @param aFile stream to which the content needs to be written.

	 * @param aIsArrayElement Whether the instance is part of an array or not.

	 */

	virtual void Write (TSISStream& aFile, const bool aIsArrayElement) const;

	/**

	 * Actual size of the content in memory.

	 * @param aInsideArray Whethere the instance is part of an array or not.

	 */

	virtual TFieldSize ByteCount (const bool aInsideArray) const;

	/**

	 * Write the content into the stream.

	 * @param aStream Stream to which the data needs to be written.

	 * @param aLevel.

	 */

	virtual void Dump (std::ostream& aStream, const int aLevel) const;

	/**

	 * Check whether the content needs to be written into the stream or

	 * not. For string if it is empty there is no need in trying to write

	 * this content. 

	 */

	virtual bool WasteOfSpace () const;

	/**

	 * Calculate CRC of the data.

	 * @param aCRC CRC value of the string.

	 * @param aIsArrayElement Whether the instance is part of an array or not.

	 */

	virtual void CalculateCrc (TCRC& aCRC, const bool aIsArrayElement) const;

	/**

	 * Get a copy of the string.

	 */

	std::wstring GetString() const;

	/**

	 * Number of characters in the string.

	 */

	TUint32 size () const;

	/**

	 * Empty the string.

	 */

	bool empty () const;

	/**

	 * Assignment operator.

	 */

	CSISString& operator = (const std::wstring& aString);

	/**

	 * Assignment operator.

	 */

	CSISString& operator = (const wchar_t* aString);

	/**

	 * Assignment operator.

	 */

	CSISString& operator = (const CSISString& aString);

	/**

	 * == operator. Compare the content of the class and aString

	 */

	bool operator == (const std::wstring& aString) const;

	/**

	 * == operator. Compare the content of the class and aString

	 */

	bool operator == (const wchar_t* aString) const;

	/**

	 * == operator. Compare the content of the class and aString

	 */

	bool operator == (const CSISString& aString) const;

	/**

	 * != operator. Compare the content of the class and aString

	 */

	bool operator != (const std::wstring& aString) const;

	/**

	 * != operator. Compare the content of the class and aString

	 */

	bool operator != (const wchar_t* aString) const;

	/**

	 * != operator. Compare the content of the class and aString

	 */

	bool operator != (const CSISString& aString) const;

	/**

	 * Adds the write the package details into the stream.

	 * @param aStream - Stream in which the package entries need to be written.

	 * @param aVerbose - If this option is set then detail description of pkg

	 * 			will be written into the stream.

	 */

	void AddPackageEntry(std::wostream& aStream, bool aVerbose) const;

	/**

	 * Delete the temporary buffer used for reading the string.

	 * Should be called after this class is not required anymore.

	 */

	static void ExitInstance ();

private:

	std::wstring iData;

	};

inline CSISString::CSISString ()

	{

	}

inline CSISString::CSISString (const std::wstring& aValue) :

			iData (aValue)

	{

	}

inline CSISString::CSISString (const bool aRequired) :

			CSISField<CSISFieldRoot::ESISString> (aRequired)

	{

	}

inline CSISString::CSISString (const std::wstring initialValue, const bool aRequired) :

			CSISField<CSISFieldRoot::ESISString> (aRequired),

			iData (initialValue)

	{

	}

inline CSISString::CSISString (const CSISString& aString) :

			CSISField<CSISFieldRoot::ESISString> (aString.Required ()),

			iData (aString.iData)

	{

	}

inline TUint32 CSISString::size () const

	{

	return static_cast <TUint32> (iData.size ()); 

	}

inline CSISString& CSISString::operator = (const std::wstring& aString)

	{

	iData = aString;

	return *this;

	}

inline CSISString& CSISString::operator = (const CSISString& aString)

	{

	iData = aString.iData;

	return *this;

	}

inline CSISString& CSISString::operator = (const wchar_t* aString)

	{

	if (aString)

		{

		iData = aString;

		}

	return *this;

	}

inline bool CSISString::operator == (const std::wstring& aString) const

	{

	return iData == aString;

	}

inline bool CSISString::operator == (const CSISString& aString) const

	{

	return iData == aString.iData;

	}

inline bool CSISString::operator == (const wchar_t* aString) const

	{

	if (aString == NULL)

		{

		return false;

		}

	return iData.compare (aString) == 0;

	}

inline bool CSISString::operator != (const std::wstring& aString) const

	{

	return iData != aString;

	}

inline bool CSISString::operator != (const CSISString& aString) const

	{

	return iData != aString.iData;

	}

inline bool CSISString::operator != (const wchar_t* aString) const

	{

	if (aString == NULL)

		{

		return true;

		}

	return iData.compare (aString) != 0;

	}

inline bool CSISString::empty () const

	{

	return iData.empty ();

	}

inline std::wstring CSISString::GetString() const

	{

	return iData;

	}

inline void CSISString::AddPackageEntry(std::wostream& aStream, bool aVerbose) const

	{

	(void)aVerbose;

	aStream << iData;

	}

#endif // __SISSTRING_H__