// 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 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:

 // This file contains the API definition for the classes TDelimitedParserBase8

 // and CDelimitedData8. 

 // 

 //

 /**

  @file DelimitedParser8.h

  @publishedAll

  @released	

 */

 #ifndef __DELIMITEDPARSER8_H__

 #define __DELIMITEDPARSER8_H__

 // System includes

 //

 #include <e32base.h>

 #include <delimitedparsercommon.h>

 /**

 Comments : Provides non-modifying functionality for parsing data delimited by 

 a single character. The data is delimited into segments. Uses 8-bit descriptors.

 The object contains a descriptor with the data which can be parsed from left 

 to right, or right to left. It is non-owning. The current segment can be extracted, 

 which then parses the string for the next segment.

 This is a base class and an object of this type cannot be instantiated. It should

 be derived. The derived class should ensure that the data iDataDes is set before 

 calling one of the protected parsing functions. The derived class should also ensure 

 that the delimiting character has been set.

 If the data iDataDes has not been parsed, then calling any functionality that 

 requires the data to have been parsed will result in a panic 

 KDelimitedParserErrNotParsed. The data can only be parsed by calling one of the

 protected parsing functions from the derived class.

 If the delimiting character iDelimiter has not been set, then calling the protected

 parsing functions and some of the other public functionality that requires the 

 delimiter to be set will result in a panic KDelimitingParserErrNoDelimiter.

 @publishedAll

 @released

 @since 6.0

 */

 class TDelimitedParserBase8

 	{

 public:	// Methods

 	IMPORT_C void Reset() const;

 	IMPORT_C TInt GetNext(TPtrC8& aSegment) const;

 	IMPORT_C TInt Inc() const;

 	IMPORT_C TInt Dec() const;

 	IMPORT_C TInt Peek(TPtrC8& aSegment) const;

 	IMPORT_C TBool Eos() const;

 	IMPORT_C TBool FrontDelimiter() const;

 	IMPORT_C TBool BackDelimiter() const;

 	IMPORT_C const TDesC8& Des() const;

 	IMPORT_C TInt Remainder(TPtrC8& aRemainder) const;

 protected:	// Methods

 	IMPORT_C TDelimitedParserBase8();

 	IMPORT_C void Parse(const TDesC8& aData);

 	IMPORT_C void ParseReverse(const TDesC8& aData);

 	IMPORT_C void SetDelimiter(TChar aDelimiter);

 private:	// Methods

 	void DoParse(const TDesC8& aData);

 	TInt FindNextSegment(TInt aStartPos) const;

 	TInt FindPrevSegment(TInt aStartPos) const;

 private:	// Attributes

 	/** Descriptor with the string

 	 */

 	TPtrC8						iDataDes;

 	/** Descriptor with the current segment.

 	 */

 	mutable TPtrC8				iCurrentSegment;

 	/** Position of next segment.

 	 */

 	mutable TInt				iNextSegmentPos;

 	/** Direction of parsing.

 	 */

 	TDelimitedDataParseMode		iMode;

 	/** Delimiting character

 	*/

 	TInt						iDelimiter;

 /**

 	A friend class.

 	@see		CDelimitedDataBase8

 	@since		6.0

  */

 	friend class CDelimitedDataBase8;

 	};

 /**

 Dependencies : CBase, TDelimitedParserBase8

 Comments : Provides functionality for creating and editing a delimited data object.

 Uses 8-bit descriptors

 The object contains a descriptor buffer with the data. Functionality is provided 

 to allow segments to be added or removed from the data. There is access to the 

 internal delimited data parser to provide parsing functionality to be excercised 

 on the created data.

 This a base class that cannot be instantiated. It should be derived. The derived 

 class must set the delimited data parser, which is an object derived from 

 TDelimitedParserBase. This helper class must set the delimiting object

 If the delimiting character has not been set, then calling any of the functionality 

 will cause a panic KDelimitedParserErrNoDelimiter.

 @publishedAll

 @released

 @since 6.0

 */

 class CDelimitedDataBase8 : public CBase

 	{

 public: // Methods

 	IMPORT_C ~CDelimitedDataBase8();

 	IMPORT_C void InsertCurrentL(const TDesC8& aSegment);

 	IMPORT_C void RemoveCurrentL();

 	IMPORT_C void PushBackL(const TDesC8& aSegment);

 	IMPORT_C void PopBackL();

 	IMPORT_C void PushFrontL(const TDesC8& aSegment);

 	IMPORT_C void PopFrontL();

 	IMPORT_C void TrimFrontDelimiterL();

 	IMPORT_C void AddFrontDelimiterL();

 	IMPORT_C void TrimBackDelimiterL();

 	IMPORT_C void AddBackDelimiterL();

 	IMPORT_C void Parse();

 	IMPORT_C void ParseReverse();

 	IMPORT_C const TDelimitedParserBase8& Parser() const;

 protected:	// Methods

 	IMPORT_C CDelimitedDataBase8();

 	IMPORT_C void ConstructL(const TDesC8& aData);

 	IMPORT_C void SetDelimiter(TChar aDelimiter);

 private:	// Methods

 	void SetDataL(const TDesC8& aData);

 	void SetData(HBufC8* aDataBuf);

 	void DoInsertL(const TDesC8& aSegment);

 	void DoRemoveL();

 private:	// Attributes

 	/** Descriptor buffer.

 	 */

 	HBufC8*					iDataBuf;

 	/** Parser object

 	 */

 	TDelimitedParserBase8	iParser;

 	};

 #endif	// __DELIMITEDPARSER8_H__