Class CDelimitedPath16

class CDelimitedPath16 : public CDelimitedDataBase16;

Support

Supported from 7.0

Description

Creates and edits 16-bit paths, owned by an object of this type, whose components are delimited by the '/' character, as defined in RFC2396.

Derivation

CBase Base class for all classes to be instantiated on the heap CDelimitedDataBase16 Implements the functionality for creating and editing 16-bit data, owned by an object of this type, that can be divided into segments delimited by a single character CDelimitedPath16 Creates and edits 16-bit paths, owned by an object of this type, whose components are delimited by the '/' character, as defined in RFC2396

Defined in CDelimitedPath16:
CDelimitedPath16(), ConstructL(), InsertAndEscapeCurrentL(), NewL(), NewLC(), PushAndEscapeBackL(), PushAndEscapeFrontL(), ~CDelimitedPath16()

Inherited from CBase:
operator new()

Inherited from CDelimitedDataBase16:
AddBackDelimiterL(), AddFrontDelimiterL(), InsertCurrentL(), Parse(), ParseReverse(), Parser(), PopBackL(), PopFrontL(), PushBackL(), PushFrontL(), RemoveCurrentL(), SetDelimiter(), TrimBackDelimiterL(), TrimFrontDelimiterL()

static CDelimitedPath16* NewL(const TDesC16& aPath);

Description

Creates a new object of this type.

This is implemented in the standard two-phase construction way.

Parameters

const TDesC16& aPath The initial data.

Return value

CDelimitedPath16* A pointer to the new object

static CDelimitedPath16* NewLC(const TDesC16& aPath);

Description

Creates a new object of this type, and puts a pointer to it into the cleanup stack.

This is implemented in the standard two-phase construction way.

Parameters

const TDesC16& aPath The initial data.

Return value

CDelimitedPath16* A pointer to the new object

~CDelimitedPath16();

Description

Destructor.

Frees any resources before destruction of the object.

void InsertAndEscapeCurrentL(const TDesC16& aSegment);

Description

Creates an escaped version of the specified segment and inserts it in front of the current segment.

The new segment should only contain a single path segment, as any path delimiters within it will be converted to an escape triple.

The segment identified as the current segment is the same one as before this function was called.

Parameters

const TDesC16& aSegment The new (unescaped) segment to be inserted.

Leave codes

KErrNoMemory The function may allocate memory, and will leave if there is insufficient.

Panic codes

DELIM-PARSER -5005 if the data has not been parsed. DELIM-PARSER -5004 if the delimiter has not been set.

void PushAndEscapeFrontL(const TDesC16& aSegment);

Description

Creates an escaped version of the specified segment and inserts it at the front of the path.

The new segment should only contain a single path segment, as any path delimiters within it will be converted to an escape triple.

The segment identified as the current segment is the same one as before this function was called.

CDelimitedDataBase16::Parse() or CDelimitedDataBase16::ParseReverse() must be called afterwards.

Parameters

const TDesC16& aSegment The new (unescaped) segment to be inserted.

Leave codes

KErrNoMemory The function may allocate memory, and will leave if there is insufficient.

Panic codes

DELIM-PARSER -5005 if the data has not been parsed. DELIM-PARSER -5004 if the delimiter has not been set.

void PushAndEscapeBackL(const TDesC16& aSegment);

Description

Creates an escaped version of the specified segment and adds it to the back of the path.

The new segment should only contain a single path segment, as any path delimiters within it will be converted to an escape triple.

The segment identified as the current segment is the same one as before this function was called.

CDelimitedDataBase16::Parse() or CDelimitedDataBase16::ParseReverse() must be called afterwards.

Parameters

const TDesC16& aSegment The new (unescaped) segment to be inserted.

Leave codes

KErrNoMemory The function may allocate memory, and will leave if there is insufficient.

Panic codes

DELIM-PARSER -5005 if the data has not been parsed. DELIM-PARSER -5004 if the delimiter has not been set.

private: CDelimitedPath16();

Description

This is internal and is not intended for use.

private: void ConstructL(const TDesC16& aPath);

Description

This is internal and is not intended for use.