// Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "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:

//

#include <delimitedparser8.h>

#include <delimitedparser16.h>

#include "DelimitedParserInternal.h"

#include <uriutilscommon.h>

// Panic category

//

_LIT(KDelimitedParserPanicCategory,"DELIM-PARSER"); 

//

//

// Implementation of TDelimitedParserBase8

//

//

/**

	Constructor.

	@since			6.0

*/

EXPORT_C TDelimitedParserBase8::TDelimitedParserBase8()

: iDataDes(0,0), iCurrentSegment(0,0), iNextSegmentPos(-1), iMode(EDelimitedDataNotParsed), iDelimiter(0)

	{

	}

/**

	Resets the internal pointer position to the start or end or the descriptor

	depending on whether the decriptor is parsing mode.

	@warning		There will be a KUriUtilsErrBadDelimitedParserMode panic if the data mode has 

	not been correctly set.

 */

EXPORT_C void TDelimitedParserBase8::Reset() const

	{

	iNextSegmentPos = InitialDelimiterPosition(iDataDes, iMode);

	}

/**

	Retrieves the current segment and then parses the data to the next one.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not 

	been set.

	@since			6.0

	@param			aSegment	This is an output argument that is set to the current segment.

	@return			A error value of KErrNotFound if there is no current segment. The 

	value KErrNone if there is a current segment.

	@pre 			The string must have been initially parsed by Parse() or ParseReverse(). 

	@post			The current segment is updated to the next one.

*/

EXPORT_C TInt TDelimitedParserBase8::GetNext(TPtrC8& aSegment) const

	{

	__ASSERT_ALWAYS(iMode != EDelimitedDataNotParsed, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNotParsed));

	__ASSERT_ALWAYS(iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	// Check that there is a segment

	if( iNextSegmentPos == KErrNotFound )

		{

		// There is no segment

		return KErrNotFound;

		}

	// There is one - set aSegment

	aSegment.Set(iCurrentSegment);

	// Parse the next segment

	iNextSegmentPos = FindNextSegment(iNextSegmentPos);

	return KErrNone;

	}

/**

	Parses to the next segment.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not 

	been set.

	@since			6.0

	@return			A error value of KErrNotFound if there is no current segment. The 

	value KErrNone if there is a current segment.

	@pre 			The string must have been initially parsed by Parse() or ParseReverse(). 

	@post			The current segment is updated to the next one.

 */	

EXPORT_C TInt TDelimitedParserBase8::Inc() const

	{

	__ASSERT_ALWAYS(iMode != EDelimitedDataNotParsed, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNotParsed));

	__ASSERT_ALWAYS(iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	// Check that there is a segment

	if( iNextSegmentPos == KErrNotFound )

		{

		// There is no segment

		return KErrNotFound;

		}

	// Parse the next segment

	iNextSegmentPos = FindNextSegment(iNextSegmentPos);

	return KErrNone;

	}

/**

	Parses back to the previous segment.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not 

	been set.

	@since			6.0

	@return			A error value of KErrNotFound if the current segment is the initial 

	segment. The value KErrNone if the data has been parsed to the previous segment.

	@pre 			The string must have been initially parsed by Parse() or ParseReverse(). 

	@post			If the parse was successful then the  current segment is updated 

	to the previous one. Otherwise there is no change.

*/

EXPORT_C TInt TDelimitedParserBase8::Dec() const

	{

	__ASSERT_ALWAYS(iMode != EDelimitedDataNotParsed, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNotParsed));

	__ASSERT_ALWAYS(iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	// Find position of previous delimiter 

	TInt prev = PrevDelimiterPosition(iDataDes, iNextSegmentPos, iDelimiter, iMode);

	// Get the previous segment

	if( FindPrevSegment(prev) == KErrNotFound )

		{

		// There is no previous segment - set to start of data

		return KErrNotFound;

		}

	// Update next segment position

	iNextSegmentPos = prev;

	return KErrNone;

	}

/**

	Retrieves the current segment.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not 

	been set.

	@since			6.0

	@param			aSegment	This is an output argument that is set to the current segment.

	@return			A error value of KErrNotFound if there is no current segment. The 

	value KErrNone if there is a current segment.

	@pre 			The string must have been initially parsed by Parse() or ParseReverse(). 

*/

EXPORT_C TInt TDelimitedParserBase8::Peek(TPtrC8& aSegment) const

	{

	__ASSERT_ALWAYS(iMode != EDelimitedDataNotParsed, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNotParsed));

	__ASSERT_ALWAYS(iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	// Check that there is a segment

	if( iNextSegmentPos == KErrNotFound )

		{

		// There is no segment

		return KErrNotFound;

		}

	// There is one - set aSegment

	aSegment.Set(iCurrentSegment);

	return KErrNone;

	}

/**

	Indicates whether the end of the data has been reached and there are no more segments 

	to parse.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not 

	been set.

	@since			6.0

	@return			A boolean value of ETrue if the end of the data has been reached,

	or EFalse if there are more segements to parse.

	@pre 			The string must have been initially parsed by Parse() or ParseReverse(). 

*/

EXPORT_C TBool TDelimitedParserBase8::Eos() const

	{

	__ASSERT_ALWAYS(iMode != EDelimitedDataNotParsed, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNotParsed));

	TBool eos = iNextSegmentPos == KErrNotFound ? ETrue : EFalse;

	return eos;

	}

/**

	Checks for a delimiter at the front (left) of the data.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set.

	@since			6.0

	@return			A boolean of value ETrue if there is a front delimiter, or EFalse 

	if there is no front delimiter.

	@pre 			The string must have been initially parsed by Parse() or ParseReverse(). 

*/

EXPORT_C TBool TDelimitedParserBase8::FrontDelimiter() const

	{

	__ASSERT_ALWAYS(iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	return (iDataDes.Locate(iDelimiter) == 0);

	}

/**

	Checks for a delimiter at the back (right) of the data.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not 

	been set.

	@since			6.0

	@return			A boolean of value ETrue if there is a back delimiter, or EFalse 

	if there is no back delimiter.

	@pre 			The string must have been initially parsed by Parse() or ParseReverse(). 

*/

EXPORT_C TBool TDelimitedParserBase8::BackDelimiter() const

	{

	__ASSERT_ALWAYS(iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	TInt delimiterPos = iDataDes.LocateReverse(iDelimiter);

	if( delimiterPos == KErrNotFound )

		return EFalse;

	return (delimiterPos == iDataDes.Length() - 1);

	}

/**

	Retrieves the descriptor reference with the data

	@since			6.0

	@return			A const descriptor reference with the data.

*/

EXPORT_C const TDesC8& TDelimitedParserBase8::Des() const

	{

	return iDataDes;

	}

/**

	Gives the remainder of the data from (and including) the current segment. Any other segments 

	that have parsed through are not included.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not 

	been set.

	@since			6.0

	@param			aRemainder	This is an output argument that is set to the remaining data.

	@return			An error value of KErrNotFound if there is no remaining data, or 

	value of KErrNone if there is remaining data.

	@pre 			The data must have been initially parsed by Parse() or ParseReverse().

 */

EXPORT_C TInt TDelimitedParserBase8::Remainder(TPtrC8& aRemainder) const

	{

	__ASSERT_ALWAYS(iMode != EDelimitedDataNotParsed, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNotParsed));

	__ASSERT_ALWAYS(iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	// Check to see if there is a segment left

	if( iNextSegmentPos == KErrNotFound )

		{

		// There is no segment

		return KErrNotFound;

		}

	// Find the previous delimiter -> the start of the current segment

	TInt prev = PrevDelimiterPosition(iDataDes, iNextSegmentPos, iDelimiter, iMode);

	// Need to see which direction the parsing is going to set the remainder

	switch(iMode)

		{

	case EDelimitedDataForward:

		{

		aRemainder.Set(iDataDes.Right(iDataDes.Length() - prev));

		} break;

	case EDelimitedDataReverse:

		{

		aRemainder.Set(iDataDes.Left(prev));

		} break;

	default:

		// Bad mode!

		User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrBadDelimitedParserMode);

		break;

		}

	return KErrNone;

	}

/**

	This parses the data into segments from left to right.

	@warning		There will be a KDelimitedParserErrNoDelimiter panic if the delimiter

	has not been set.

	@since			6.0

	@param			aData	A descriptor containing the data.

	@pre 			The delimiter must have been set.

	@post			The current segment is the leftmost segment and the direction of 

	parsing is set from left to right (EDelimitedDataFroward).

 */

EXPORT_C void TDelimitedParserBase8::Parse(const TDesC8& aData)

	{

	__ASSERT_ALWAYS(iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	// Initialise data for EForward direction

	iMode = EDelimitedDataForward;

	DoParse(aData);

	}

/**

	This parses the data into segments from lright to left.

	@warning		There will be a KDelimitedParserErrNoDelimiter panic if the delimiter

	has not been set.

	@since			6.0

	@param			aData	A descriptor containing the data.

	@pre 			The delimiter must have been set.

	@post			The current segment is the leftmost segment and the direction of 

	parsing is set from right to left (EDelimitedDataReverse).

 */

EXPORT_C void TDelimitedParserBase8::ParseReverse(const TDesC8& aData)

	{

	__ASSERT_ALWAYS(iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	// Initialise data for EReverse direction

	iMode = EDelimitedDataReverse;

	DoParse(aData);

	}

/**

	Sets the delimiting character.

	@since			6.0

	@param			aDelimiter	The delimiting character.

	@post			The delimiting character is set.

*/

EXPORT_C void TDelimitedParserBase8::SetDelimiter(TChar aDelimiter)

	{

	iDelimiter = aDelimiter;

	}

/**

	Initialises the parsing of the data.

	@since			6.0

	@param			aData	A descriptor reference with the data.

	@pre 			The delimiting character has been set.

	@post			The data descriptor is set to the input argument. The current 

	segment refers to the initial segment of the data.

*/

void TDelimitedParserBase8::DoParse(const TDesC8& aData)

	{

	// Reset the segment information, then set the new Data - set pointer to NULL and length to zero

	iCurrentSegment.Set(NULL,0);

	iDataDes.Set(aData);

	// Check that there is a string!

	if( iDataDes.Length() == 0 )

		{

		// No string - ensure functionality blocked for this descriptor

		iNextSegmentPos = KErrNotFound;

		return;

		}

	// Find the segment - search from initial start position

	iNextSegmentPos = FindNextSegment(InitialDelimiterPosition(iDataDes, iMode));

	}

/**

	Finds the next segment from the given start position.

	@since			6.0

	@param			aStartPos	The position from where to start the search for the

	next segment.

	@return			The position of delimiter after the specified start position, or 

	an error value of KErrNotFound if no more delimiters are found.

*/

TInt TDelimitedParserBase8::FindNextSegment(TInt aStartPos) const

	{

	// Find position of next delimiter

	TInt next = NextDelimiterPosition(iDataDes, aStartPos, iDelimiter, iMode);

	if( next != KErrNotFound )

		{

		TInt startPos = next < aStartPos ? next : aStartPos;

		TInt endPos = next < aStartPos ? aStartPos : next;

		if( iDataDes[startPos] == iDelimiter )

			{

			// Move past delimiter

			++startPos;

			}

		TInt length = endPos - startPos;

		iCurrentSegment.Set(iDataDes.Mid(startPos, length));

		}

	return next;

	}

/**

	Finds the previous segment from the given start position.

	@since			6.0

	@param			aStartPos	The position from where to start the search for the

					previous segment.

	@return			The position of delimiter before the specified start position, or 

	an error value of KErrNotFound if no more delimiters are found.

*/

TInt TDelimitedParserBase8::FindPrevSegment(TInt aStartPos) const

	{

	// Find position of previous delimiter 

	TInt prev = PrevDelimiterPosition(iDataDes, aStartPos, iDelimiter, iMode);

	if( prev != KErrNotFound )

		{

		TInt startPos = prev < aStartPos ? prev : aStartPos;

		TInt endPos = prev < aStartPos ? aStartPos : prev;

		if( iDataDes[startPos] == iDelimiter )

			{

			// Move past delimiter

			++startPos;

			}

		TInt length = endPos - startPos;

		iCurrentSegment.Set(iDataDes.Mid(startPos, length));

		}

	return prev;

	}

//

//

// Implementation of CDelimitedDataBase8

//

//

/**

	Destructor.

	@since			6.0

*/

EXPORT_C CDelimitedDataBase8::~CDelimitedDataBase8()

	{

	delete iDataBuf;

	}

/**

	Inserts the new segment in a position before the current parsed	segment. The new 

	segment can be made up of several segments and have delimiters at either extreme. 

	The insert functionality will ensure that there is always a delimiter at the front 

	of the new segment. The parser is left in a state where its current segment is the 

	same one as before the insertion.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has not been 

	parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set.

	@since			6.0

	@param			aSegment	A descriptor with the new segment to be inserted.

	@pre 			The data must have been initially parsed by Parse() or ParseReverse().

	@post			The data will have been extended to include the new segment. The 

	current segment will remain as the one before the insertion.

*/

EXPORT_C void CDelimitedDataBase8::InsertCurrentL(const TDesC8& aSegment)

	{

	__ASSERT_ALWAYS(iParser.iMode != EDelimitedDataNotParsed, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNotParsed));

	__ASSERT_ALWAYS(iParser.iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	DoInsertL(aSegment);

	}

/**

	Removes the current segment. After removing the segment, the parser's new current segment 

	will be the next segment. If the last segment is the one that is removed then the parser 

	will be set to the end of the data.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not 

	been set.

	@since			6.0

	@pre 			The data must have been initially parsed by Parse() or ParseReverse().

	@post			The data will have been reduced to exclude the removed segment.

	The current segment will be set to what was the next segment. If the removed segment was 

	the last segment, the parser is at the end of the data.

*/

EXPORT_C void CDelimitedDataBase8::RemoveCurrentL()

	{

	__ASSERT_ALWAYS(iParser.iMode != EDelimitedDataNotParsed, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNotParsed));

	__ASSERT_ALWAYS(iParser.iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	DoRemoveL();

	}

/**

	Adds a new segment to the end of the data. The new segment can be made up of several segments 

	and have  delimiters at either extreme. The insert functionality will ensure that there is 

	always a delimiter at the front of the new segment. The data must re-parsed to ensure that the 

	parser is valid.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not 

	been set. A re-parse is required to ensure that the parser is valid.

	@since			6.0

	@param			aSegment	A descriptor with the new segment to be inserted.

	@pre 			The delimiter must have been set. 

	@post			The data will have been extended to include the new segment.

*/

EXPORT_C void CDelimitedDataBase8::PushBackL(const TDesC8& aSegment)

	{

	__ASSERT_ALWAYS(iParser.iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	// Parse the string in reverse direction - sets last segment as current

	iParser.ParseReverse(*iDataBuf);

	// Insert the segment

	DoInsertL(aSegment);

	// Make sure that a re-parse is required

	iParser.iMode = EDelimitedDataNotParsed;

	}

/**

	Removes the last segment from the data. The data must be re-parsed to ensure that the parser is valid.

	@warning		There will be a KDelimitedParserErrNotParsed panic if the data has 

	not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not 

	been set. A re-parse is required to ensure that the parser is valid.

	@since			6.0

	@pre 			The delimiter must have been set.

	@post			The data will have been reduced to exclude the last segment. 

*/

EXPORT_C void CDelimitedDataBase8::PopBackL()

	{

	__ASSERT_ALWAYS(iParser.iDelimiter != 0, User::Panic(KDelimitedParserPanicCategory, KUriUtilsErrNoDelimiter));

	// Parse the string in reverse direction - sets last segment as current

	iParser.ParseReverse(*iDataBuf);

	// Remove the current segment