Symbian^3 Application Developer Library >

CDelimitedDataBase8 Class Reference

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.
Since
6.0

Inherits from

Public Member Functions
~CDelimitedDataBase8 ()
IMPORT_C void AddBackDelimiterL ()
IMPORT_C void AddFrontDelimiterL ()
IMPORT_C void InsertCurrentL (const TDesC8 &)
IMPORT_C void Parse ()
IMPORT_C void ParseReverse ()
IMPORT_C const TDelimitedParserBase8 & Parser ()
IMPORT_C void PopBackL ()
IMPORT_C void PopFrontL ()
IMPORT_C void PushBackL (const TDesC8 &)
IMPORT_C void PushFrontL (const TDesC8 &)
IMPORT_C void RemoveCurrentL ()
IMPORT_C void TrimBackDelimiterL ()
IMPORT_C void TrimFrontDelimiterL ()
Protected Member Functions
CDelimitedDataBase8 ()
IMPORT_C void ConstructL (const TDesC8 &)
IMPORT_C void SetDelimiter ( TChar )
Private Member Functions
void DoInsertL (const TDesC8 &)
void DoRemoveL ()
void SetData ( HBufC8 *)
void SetDataL (const TDesC8 &)
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Private Attributes
HBufC8 * iDataBuf
TDelimitedParserBase8 iParser

Constructor & Destructor Documentation

CDelimitedDataBase8()

IMPORT_C CDelimitedDataBase8 ( ) [protected]

Constructor. First phase of two-phase construction method. Does non-allocating construction.

Since
6.0

~CDelimitedDataBase8()

IMPORT_C ~CDelimitedDataBase8 ( )

Destructor.

Since
6.0

Member Functions Documentation

AddBackDelimiterL()

IMPORT_C void AddBackDelimiterL ( )

Adds a delimiter to the back of the data (if it doesn't exist).

CAUTION:

There will be a KDelimitedParserErrNotParsed panic if the data has not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set. A re-parse is required to ensure that the parser is valid.

Since
6.0
Pre-condition
The delimiter must have been set.
Post-condition
The data might have been extended to include a front delimiter.

AddFrontDelimiterL()

IMPORT_C void AddFrontDelimiterL ( )

Adds a delimiter to the front of the data (if it doesn't exist).

CAUTION:

There will be a KDelimitedParserErrNotParsed panic if the data has not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set. A re-parse is required to ensure that the parser is valid.

Since
6.0
Pre-condition
The delimiter must have been set.
Post-condition
The data might have been extended to include a front delimiter.

ConstructL(const TDesC8 &)

IMPORT_C void ConstructL ( const TDesC8 & aData ) [protected]

Second phase of two-phase construction method. Does any allocations required to fully construct the object.

Since
6.0
Pre-condition
First phase of construction is complete.
Post-condition
The object is fully constructed.

Parameters

const TDesC8 & aData A descriptor with the initial string.

DoInsertL(const TDesC8 &)

void DoInsertL ( const TDesC8 & aSegment ) [private]

Inserts the new segment in a position before the current 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 will be left in a state where its current segment is the same one as before the insertion.

Since
6.0
Pre-condition
The string must have been parsed.
Post-condition
The string will have been extended to include the new segment. The current segment will remain as the one before the insertion.

Parameters

const TDesC8 & aSegment The descriptor with the segment to be inserted.

DoRemoveL()

void DoRemoveL ( ) [private]

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.

Since
6.0
Pre-condition
The data must have been parsed.
Post-condition
The data will have been reduced to exclude the removed data. The current segment is set to what was the next segment. If the removed segment was the last segment, the parser is at the end of the data.

InsertCurrentL(const TDesC8 &)

IMPORT_C void InsertCurrentL ( const TDesC8 & aSegment )

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.

CAUTION:

There will be a KDelimitedParserErrNotParsed panic if the data has not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set.

Since
6.0
Pre-condition
The data must have been initially parsed by Parse() or ParseReverse() .
Post-condition
The data will have been extended to include the new segment. The current segment will remain as the one before the insertion.

Parameters

const TDesC8 & aSegment A descriptor with the new segment to be inserted.

Parse()

IMPORT_C void Parse ( )

This parses the data into segments from left to right.

CAUTION:

There will be a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set.

Since
6.0
Pre-condition
The delimiter must have been set.
Post-condition
The current segment is the leftmost segment and the direction of parsing is set from left to right (EDelimitedDataFroward).

ParseReverse()

IMPORT_C void ParseReverse ( )

This parses the string into segments from right to left.

Since
6.0
Pre-condition
The delimiter must have been set. Will get a KDelimitedParserErrNoDelimiter panic if the delimiter has not been initialized.
Post-condition
The current segment is the leftmost segment and the direction of parsing is right to left.

Parser()

IMPORT_C const TDelimitedParserBase8 & Parser ( ) const

Retrieves a const reference to the delimited data parser.

Since
6.0

PopBackL()

IMPORT_C void PopBackL ( )

Removes the last segment from the data. The data must be re-parsed to ensure that the parser is valid.

CAUTION:

There will be a KDelimitedParserErrNotParsed panic if the data has not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set. A re-parse is required to ensure that the parser is valid.

Since
6.0
Pre-condition
The delimiter must have been set.
Post-condition
The data will have been reduced to exclude the last segment.

PopFrontL()

IMPORT_C void PopFrontL ( )

Removes the first segment from the data. The data must be re-parsed to ensure that the parser is valid.

CAUTION:

There will be a KDelimitedParserErrNotParsed panic if the data has not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set. A re-parse is required to ensure that the parser is valid.

Since
6.0
Pre-condition
The delimiter must have been set.
Post-condition
The data will have been reduced to exclude the last segment.

PushBackL(const TDesC8 &)

IMPORT_C void PushBackL ( const TDesC8 & aSegment )

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.

CAUTION:

There will be a KDelimitedParserErrNotParsed panic if the data has not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set. A re-parse is required to ensure that the parser is valid.

Since
6.0
Pre-condition
The delimiter must have been set.
Post-condition
The data will have been extended to include the new segment.

Parameters

const TDesC8 & aSegment A descriptor with the new segment to be inserted.

PushFrontL(const TDesC8 &)

IMPORT_C void PushFrontL ( const TDesC8 & aSegment )

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.

CAUTION:

There will be a KDelimitedParserErrNotParsed panic if the data has not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set. A re-parse is required to ensure that the parser is valid.

Since
6.0
Pre-condition
The delimiter must have been set.
Post-condition
The data will have been extended to include the new segment.

Parameters

const TDesC8 & aSegment A descriptor with the new segment to be inserted.

RemoveCurrentL()

IMPORT_C void RemoveCurrentL ( )

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.

CAUTION:

There will be a KDelimitedParserErrNotParsed panic if the data has not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set.

Since
6.0
Pre-condition
The data must have been initially parsed by Parse() or ParseReverse() .
Post-condition
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.

SetData(HBufC8 *)

void SetData ( HBufC8 * aDataBuf ) [private]

Sets internal data buffer and parser. Cleans up the old data and uses the data buffer. The parser is set to the new data.

Since
6.0
Post-condition
The internal data buffer now points to the new buffer and the parser is set to the data in the new buffer..

Parameters

HBufC8 * aDataBuf A pointer to a decriptor buffer with the new data.

SetDataL(const TDesC8 &)

void SetDataL ( const TDesC8 & aData ) [private]

Updates internal data buffer with the new data. Creates a copy of the new data.

Since
6.0
Post-condition
The internal data buffer now contains a copy of the new data and the parser is set to the new data.

Parameters

const TDesC8 & aData A descriptor with the new string.

SetDelimiter(TChar)

IMPORT_C void SetDelimiter ( TChar aDelimiter ) [protected]

Sets the delimiting character.

Since
6.0
Post-condition
The delimiting character is updated.

Parameters

TChar aDelimiter The delimiting character.

TrimBackDelimiterL()

IMPORT_C void TrimBackDelimiterL ( )

Removes the back delimiter (if exists) from the data.

CAUTION:

There will be a KDelimitedParserErrNotParsed panic if the data has not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set. A re-parse is required to ensure that the parser is valid.

Since
6.0
Pre-condition
The delimiter must have been set.
Post-condition
The data might have been reduced to exclude the front delimiter.

TrimFrontDelimiterL()

IMPORT_C void TrimFrontDelimiterL ( )

Removes the front delimiter (if exists) from the data.

CAUTION:

There will be a KDelimitedParserErrNotParsed panic if the data has not been parsed, and a KDelimitedParserErrNoDelimiter panic if the delimiter has not been set. A re-parse is required to ensure that the parser is valid.

Since
6.0
Pre-condition
The delimiter must have been set.
Post-condition
The data might have been reduced to exclude the front delimiter.

Member Data Documentation

HBufC8 * iDataBuf

HBufC8 * iDataBuf [private]

Descriptor buffer.

TDelimitedParserBase8 iParser

TDelimitedParserBase8 iParser [private]

Parser object

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.