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