--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/secureswitools/swisistools/source/sisxlibrary/sisstring.h	Thu Dec 17 08:51:10 2009 +0200
@@ -0,0 +1,285 @@
+/*
+* 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__
+