--- a/epoc32/include/delimitedparser16.h Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/delimitedparser16.h Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,231 @@
-delimitedparser16.h
+// 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 TDelimitedParserBase16
+// and CDelimitedData16.
+//
+//
+
+
+
+/**
+ @file DelimitedParser16.h
+ @publishedAll
+ @released
+*/
+
+#ifndef __DELIMITEDPARSER16_H__
+#define __DELIMITEDPARSER16_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 16-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 TDelimitedParserBase16
+ {
+public: // Methods
+
+ IMPORT_C void Reset() const;
+
+ IMPORT_C TInt GetNext(TPtrC16& aSegment) const;
+
+ IMPORT_C TInt Inc() const;
+
+ IMPORT_C TInt Dec() const;
+
+ IMPORT_C TInt Peek(TPtrC16& aSegment) const;
+
+ IMPORT_C TBool Eos() const;
+
+ IMPORT_C TBool FrontDelimiter() const;
+
+ IMPORT_C TBool BackDelimiter() const;
+
+ IMPORT_C const TDesC16& Des() const;
+
+ IMPORT_C TInt Remainder(TPtrC16& aRemainder) const;
+
+protected: // Methods
+
+ IMPORT_C TDelimitedParserBase16();
+
+ IMPORT_C void Parse(const TDesC16& aData);
+
+ IMPORT_C void ParseReverse(const TDesC16& aData);
+
+ IMPORT_C void SetDelimiter(TChar aDelimiter);
+
+private: // Methods
+
+ void DoParse(const TDesC16& aData);
+
+ TInt FindNextSegment(TInt aStartPos) const;
+
+ TInt FindPrevSegment(TInt aStartPos) const;
+
+private: // Attributes
+
+ /** Descriptor with the string
+ */
+ TPtrC16 iDataDes;
+
+ /** Descriptor with the current segment.
+ */
+ mutable TPtrC16 iCurrentSegment;
+
+ /** Position of next segment.
+ */
+ mutable TInt iNextSegmentPos;
+
+ /** Direction of parsing.
+ */
+ TDelimitedDataParseMode iMode;
+
+ /** Delimiting character
+ */
+ TInt iDelimiter;
+
+/**
+ A friend class.
+ @see CDelimitedDataBase16
+ @since 6.0
+ */
+ friend class CDelimitedDataBase16;
+
+ };
+
+/**
+typedef
+@publishedAll
+@released
+*/
+typedef TDelimitedParserBase16 TDelimitedParserBase;
+
+/**
+Dependencies : CBase, TDelimitedParserBase16
+Comments : Provides functionality for creating and editing a delimited data object.
+Uses 16-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 CDelimitedDataBase16 : public CBase
+ {
+public: // Methods
+
+
+ IMPORT_C ~CDelimitedDataBase16();
+
+ IMPORT_C void InsertCurrentL(const TDesC16& aSegment);
+
+ IMPORT_C void RemoveCurrentL();
+
+ IMPORT_C void PushBackL(const TDesC16& aSegment);
+
+ IMPORT_C void PopBackL();
+
+ IMPORT_C void PushFrontL(const TDesC16& 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 TDelimitedParserBase16& Parser() const;
+
+protected: // Methods
+
+ IMPORT_C CDelimitedDataBase16();
+
+ IMPORT_C void ConstructL(const TDesC16& aData);
+
+ IMPORT_C void SetDelimiter(TChar aDelimiter);
+
+private: // Methods
+
+ void SetDataL(const TDesC16& aData);
+
+ void SetData(HBufC16* aDataBuf);
+
+ void DoInsertL(const TDesC16& aSegment);
+
+ void DoRemoveL();
+
+private: // Attributes
+
+ /** Descriptor buffer.
+ */
+ HBufC16* iDataBuf;
+
+ /** Parser object
+ */
+ TDelimitedParserBase16 iParser;
+
+ };
+
+/**
+typedef
+@publishedAll
+@released
+*/
+typedef CDelimitedDataBase16 CDelimitedDataBase;
+
+#endif // __DELIMITEDPARSER16_H__