genericservices/httputils/inc/DelimitedParser8.h
changeset 0 e4d67989cc36
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/genericservices/httputils/inc/DelimitedParser8.h	Tue Feb 02 02:01:42 2010 +0200
@@ -0,0 +1,215 @@
+// 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:
+// 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__