/*
* Copyright (c) 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 <e32base.h>
#include "cstringparser.h"


CStringParser::CStringParser ( const TDesC8& aBuffer ): iBuffer ( aBuffer ),
    iCurrentPos ( 0 )
	{
	}

CStringParser::~CStringParser ()
	{
	}


CStringParser* CStringParser::NewL ( const TDesC8& aBuffer )
	{
	return (new( ELeave)CStringParser( aBuffer ));
	}

/**
	Get the next character from the current position, and increments the 
	current position by 1. 
	
	@param aChar [out] Next character to be read
	
	@return TBool ETrue if the current position is less than the string length 
	else returns EFalse
 */
TBool CStringParser::GetNextCharacter ( TChar& aChar )
	{
	IncrementCurrentPos ();
	return ( GetCurrentCharacter ( aChar ) );	
	}

/**
	Get the character from the current position. 	
	
	@param aChar [out] Current character to be read
	
	@return TBool ETrue if the current position is less than the string length 
	else returns EFalse
 */
TBool CStringParser::GetCurrentCharacter ( TChar& aChar )
	{
	if ( iCurrentPos >= iBuffer.Length () )
		{
		return EFalse;		
		}
	
	aChar = iBuffer[ iCurrentPos ];
	return ETrue;
	}

/**
	Parses the string till it finds the aEndChar.
	
	@param TChar [in] Character to search for.
	@see GetNextWorrd
 */	
TBool CStringParser::ParseTill ( TPtrC8& aWord, TChar aEndChar )
	{	
	TPtrC8 cur( iBuffer.Mid( iCurrentPos ) );
	TBool found = ETrue;
	TInt pos = cur.Locate( aEndChar );
	if ( pos < 0 )
		{
		// Unable to locate the aEndChar. Sets the end position to
		// the length of the string.
		pos = iBuffer.Length (); 
		found = EFalse;
		}

	aWord.Set ( cur.Left (pos) ); 
	SkipLength ( pos );
	return found;	
	}	

/**
	Increments the current parsing position by aLen.
	
	@param TInt [in] Number of character to skip.
	
	@return TBool ETrue if the current parsing position is less than the buffer length
    else returns EFalse.
 */
TBool CStringParser::SkipLength ( TInt aLen )
	{
	iCurrentPos += aLen;

	if ( iCurrentPos < iBuffer.Length () )
		{
		return ETrue;		
		}
	return EFalse;
	}

/**
	Finds the remainder string from the current parsing position to the buffer length.
		
	@param TPtrC8& [out] Points to the current starting position till end
	
	@return TBool ETrue if the current parsing position is less than the buffer length
    else returns EFalse.
 */
void CStringParser::GetRemainder ( TPtrC8& aBuffer )
	{
	aBuffer.Set ( iBuffer.Mid ( iCurrentPos ) ); 
	SkipLength ( aBuffer.Length () );
	}

/**
 	Increments the current parsing position by 1.
  */
void CStringParser::IncrementCurrentPos ( )
	{
	++iCurrentPos;
	}

/**
	Parses till the first occurrence of any one of a set of characters in aCharSet,
	from the current parsing position.		
	
	@param TPtrC8& [out] Points to the current starting position.
	@param const TDesC8& [in] Descriptor containing characters for matching.
 */
void CStringParser::ParseTill ( TPtrC8& aWord, const TDesC8& aCharSet )
	{
	TPtrC8 cur( iBuffer.Mid( iCurrentPos ) );
	
	TInt lowpos = cur.Length ();
	TInt pos = KErrNotFound;
	
	for ( TInt i = 0; i < aCharSet.Length(); ++i )
		{
		pos = cur.Locate ( aCharSet [ i ] );
		
		if ( (pos != KErrNotFound) && (pos < lowpos ) )
			{
			lowpos = pos;				
			}
		}
		
	aWord.Set ( cur.Left ( lowpos ) );
	SkipLength ( lowpos );	
	}