CDelimitedPath8 Class Reference

class CDelimitedPath8 : public CDelimitedDataBase8
Dependencies : CDelimitedStringBase8 Comments : Provides functionality to create a delimited path where components of the path delimited by '/' as defined in RFC2396.
Since
6.0

Inherits from

Constructor & Destructor Documentation

CDelimitedPath8()

CDelimitedPath8 ( ) [private]
Constructor. First phase of two-phase construction method. Does non-allocating construction.
Since
6.0
Constructor.

~CDelimitedPath8()

IMPORT_C ~CDelimitedPath8 ( )
Destructor.
Since
6.0
Destructor.

Member Functions Documentation

ConstructL(const TDesC8 &)

void ConstructL ( const TDesC8 & aPath ) [private]
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.
Second phase of two-phase construction method. Does any allocations required to fully construct the object.
Pre-condition
First phase of construction is complete.
Post-condition
The object is fully constructed.

Parameters

const TDesC8 & aPath A descriptor with the initial string.

InsertAndEscapeCurrentL(const TDesC8 &)

IMPORT_C void InsertAndEscapeCurrentL ( const TDesC8 & aSegment )
Escape encodes the segment then inserts the escaped version in a position before the current parsed segment. The new segment should only contain a single path segment, as any path delimiters in the segment will be converted to an escape triple. The parser is left in a state where its current segment is the same one as before the insertion.
Since
6.0
Pre-condition
The path must have been initially parsed.
Post-condition
The path will have been extended to include the new segment. The current segment will remain as the one before the insertion.
Escape encodes the segment then inserts the escaped version in a position before the current parsed segment. The new segment should only contain a single path segment, as any path delimiters in the segment will be converted to an escape triple. The parser is left in a state where its current segment is the same one as before the insertion.
Pre-condition
The path must have been initially parsed.
Post-condition
The path 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 unescaped path segment.

NewL(const TDesC8 &)

IMPORT_C CDelimitedPath8 * NewL ( const TDesC8 & aPath ) [static]
Static factory constructor. Uses two phase construction and leaves nothing on the CleanupStack .
Since
6.0
Post-condition
Nothing left on the CleanupStack .
Static factory constructor. Uses two phase construction and leaves nothing on the CleanupStack .

Parameters

const TDesC8 & aPath A descriptor with the initial path.

NewLC(const TDesC8 &)

IMPORT_C CDelimitedPath8 * NewLC ( const TDesC8 & aPath ) [static]
Static factory constructor. Uses two phase construction and leaves a pointer to created object on the CleanupStack .
Since
6.0
Post-condition
Pointer to created object left of CleanupStack .
Static factory constructor. Uses two phase construction and leaves a pointer to created object on the CleanupStack .

Parameters

const TDesC8 & aPath A descriptor with the initial path.

PushAndEscapeBackL(const TDesC8 &)

IMPORT_C void PushAndEscapeBackL ( const TDesC8 & aSegment )
Escape encodes the segment then inserts the escaped version at the back of the path. The new segment should only contain a single path segment, as any path delimiters in the segment will be converted to an escape triple. The parser is left in a state where its current segment is the same one as before the insertion.
CAUTION:

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 path will have been extended to include the new segment.
Escape encodes the segment then inserts the escaped version at the back of the path. The new segment should only contain a single path segment, as any path delimiters in the segment will be converted to an escape triple. The parser is left in a state where its current segment is the same one as before the insertion.
Pre-condition
The delimiter must have been set.
Post-condition
The path will have been extended to include the new segment

Parameters

const TDesC8 & aSegment A descriptor with the unescaped path segment.

PushAndEscapeFrontL(const TDesC8 &)

IMPORT_C void PushAndEscapeFrontL ( const TDesC8 & aSegment )
Escape encodes the segment then inserts the escaped version at the front of the path. The new segment should only contain a single path segment, as any path delimiters in the segment will be converted to an escape triple. The parser is left in a state where its current segment is the same one as before the insertion.
CAUTION:

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 path will have been extended to include the new segment.
Escape encodes the segment then inserts the escaped version at the front of the path. The new segment should only contain a single path segment, as any path delimiters in the segment will be converted to an escape triple. The parser is left in a state where its current segment is the same one as before the insertion.
Pre-condition
The delimiter must have been set.
Post-condition
The path will have been extended to include the new segment

Parameters

const TDesC8 & aSegment A descriptor with the unescaped path segment.