CDelimitedPath8 Class Reference

#include <delimitedpath8.h>

class CDelimitedPath8 : public CDelimitedDataBase8

Inherits from

Detailed Description

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

Constructor & Destructor Documentation

~CDelimitedPath8 ( )

IMPORT_C~CDelimitedPath8()
Destructor.
Since
6.0
Destructor.

Member Function Documentation

InsertAndEscapeCurrentL ( const TDesC8 & )

IMPORT_C voidInsertAndEscapeCurrentL(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
aSegmentA 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
aPathA descriptor with the initial path.
Return Value
A pointer to created object. A pointer to the newly created object.

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
aPathA descriptor with the initial path.
Return Value
A pointer to created object. A pointer to the newly created object.

PushAndEscapeBackL ( const TDesC8 & )

IMPORT_C voidPushAndEscapeBackL(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
aSegmentA descriptor with the unescaped path segment.

PushAndEscapeFrontL ( const TDesC8 & )

IMPORT_C voidPushAndEscapeFrontL(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
aSegmentA descriptor with the unescaped path segment.