Location:
DelimitedParser8.h
Link against: inetprotutil.lib
class CDelimitedDataBase8 : public CBase;
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.
CBase
- Base class for all classes to be instantiated on the heap
CDelimitedDataBase8
- Dependencies :
Defined in CDelimitedDataBase8
:
AddBackDelimiterL()
, AddFrontDelimiterL()
, CDelimitedDataBase8()
, ConstructL()
, InsertCurrentL()
, Parse()
, ParseReverse()
, Parser()
, PopBackL()
, PopFrontL()
, PushBackL()
, PushFrontL()
, RemoveCurrentL()
, SetDelimiter()
, TrimBackDelimiterL()
, TrimFrontDelimiterL()
, ~CDelimitedDataBase8()
Inherited from CBase
:
Delete()
,
Extension_()
,
operator new()
protected: IMPORT_C CDelimitedDataBase8();
Constructor. First phase of two-phase construction method. Does non-allocating construction.
protected: IMPORT_C void ConstructL(const TDesC8 &aData);
First phase of construction is complete.
Second phase of two-phase construction method. Does any allocations required to fully construct the object.
The object is fully constructed.
|
IMPORT_C void InsertCurrentL(const TDesC8 &aSegment);
The data must have been initially parsed by Parse()
or ParseReverse()
.
Inserts the new segment in a position before the current parsed segment. The new segment can be made up of several segments and have delimiters at either extreme. The insert functionality will ensure that there is always a delimiter at the front of the new segment. The parser is left in a state where its current segment is the same one as before the insertion.
The data will have been extended to include the new segment. The current segment will remain as the one before the insertion.
|
IMPORT_C void RemoveCurrentL();
The data must have been initially parsed by Parse()
or ParseReverse()
.
Removes the current segment. After removing the segment, the parser's new current segment will be the next segment. If the last segment is the one that is removed then the parser will be set to the end of the data.
The data will have been reduced to exclude the removed segment. The current segment will be set to what was the next segment. If the removed segment was the last segment, the parser is at the end of the data.
IMPORT_C void PushBackL(const TDesC8 &aSegment);
The delimiter must have been set.
Adds a new segment to the end of the data. The new segment can be made up of several segments and have delimiters at either extreme. The insert functionality will ensure that there is always a delimiter at the front of the new segment. The data must re-parsed to ensure that the parser is valid.
The data will have been extended to include the new segment.
|
IMPORT_C void PopBackL();
The delimiter must have been set.
Removes the last segment from the data. The data must be re-parsed to ensure that the parser is valid.
The data will have been reduced to exclude the last segment.
IMPORT_C void PushFrontL(const TDesC8 &aSegment);
The delimiter must have been set.
Adds a new segment to the front of the data. The new segment can be made up of several segments and have delimiters at either extreme. The insert functionality will ensure that there is always a delimiter at the front of the new segment. The data must re-parsed to ensure that the parser is valid.
The data will have been extended to include the new segment.
|
IMPORT_C void PopFrontL();
The delimiter must have been set.
Removes the first segment from the data. The data must be re-parsed to ensure that the parser is valid.
The data will have been reduced to exclude the last segment.
IMPORT_C void TrimFrontDelimiterL();
The delimiter must have been set.
Removes the front delimiter (if exists) from the data.
The data might have been reduced to exclude the front delimiter.
IMPORT_C void AddFrontDelimiterL();
The delimiter must have been set.
Adds a delimiter to the front of the data (if it doesn't exist).
The data might have been extended to include a front delimiter.
IMPORT_C void TrimBackDelimiterL();
The delimiter must have been set.
Removes the back delimiter (if exists) from the data.
The data might have been reduced to exclude the front delimiter.
IMPORT_C void AddBackDelimiterL();
The delimiter must have been set.
Adds a delimiter to the back of the data (if it doesn't exist).
The data might have been extended to include a front delimiter.
IMPORT_C void Parse();
The delimiter must have been set.
This parses the data into segments from left to right.
The current segment is the leftmost segment and the direction of parsing is set from left to right (EDelimitedDataFroward).
IMPORT_C void ParseReverse();
The delimiter must have been set. Will get a KDelimitedParserErrNoDelimiter panic if the delimiter has not been initialized.
This parses the string into segments from right to left.
The current segment is the leftmost segment and the direction of parsing is right to left.
IMPORT_C const TDelimitedParserBase8 &Parser() const;
Retrieves a const reference to the delimited data parser.
|
protected: IMPORT_C void SetDelimiter(TChar aDelimiter);
Sets the delimiting character.
The delimiting character is updated.
|