CDelimitedPath16 Class Reference

class CDelimitedPath16 : public CDelimitedDataBase16
Dependencies : CDelimitedStringBase16 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

CDelimitedPath16()

CDelimitedPath16 ( ) [private]

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

Since
6.0

~CDelimitedPath16()

IMPORT_C ~CDelimitedPath16 ( )

Destructor.

Since
6.0

Member Functions Documentation

ConstructL(const TDesC16 &)

void ConstructL ( const TDesC16 & 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.

Parameters

const TDesC16 & aPath A descriptor with the initial path.

InsertAndEscapeCurrentL(const TDesC16 &)

IMPORT_C void InsertAndEscapeCurrentL ( const TDesC16 & 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.

Parameters

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

NewL(const TDesC16 &)

IMPORT_C CDelimitedPath16 * NewL ( const TDesC16 & 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 .

Parameters

const TDesC16 & aPath A descriptor with the initial path.

NewLC(const TDesC16 &)

IMPORT_C CDelimitedPath16 * NewLC ( const TDesC16 & 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 .

Parameters

const TDesC16 & aPath A descriptor with the initial path.

PushAndEscapeBackL(const TDesC16 &)

IMPORT_C void PushAndEscapeBackL ( const TDesC16 & 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.

Parameters

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

PushAndEscapeFrontL(const TDesC16 &)

IMPORT_C void PushAndEscapeFrontL ( const TDesC16 & 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.

Parameters

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