Class TParsePtr

class TParsePtr : public TParseBase;

Description

Parses filenames using less space on the stack than TParse.

Stores a reference to a filename, unlike TParse, which uses a 512 byte TFileName object as an internal buffer to store a copy of the filename. The filename's components (drive, path, etc.) can be retrieved using the functions provided by the base class, TParseBase. This class should be used in preference to TParse when minimising stack usage is a priority.

Derivation

• TParseBase - Base class for file name parsing

• TParsePtr - Parses filenames using less space on the stack than TParse

Members

Defined in TParsePtr:
NameBuf(), NameBufC(), TParsePtr()

Inherited from TParseBase:
AddDir(), Drive(), DriveAndPath(), DrivePresent(), Ext(), ExtPresent(), FullName(), IsExtWild(), IsKMatchAny(), IsKMatchOne(), IsNameWild(), IsRoot(), IsWild(), Name(), NameAndExt(), NameOrExtPresent(), NamePresent(), Path(), PathPresent(), PopDir(), iMod

See also:

• TParse
• TFileName

IMPORT_C TParsePtr(TDes &aName);

Description

Constructor taking a reference to a filename.

The specified filename is parsed and if this fails, a panic is raised.

Parameters

TDes &aName Reference to the filename to be parsed. On return contains the fully parsed path specification. If a filename and extension are specified, they may both contain wildcards. The maximum length is KMaxFileName characters.

Panic codes

FSCLIENT 24 if the the specified name fails to parse.

See also:

• KMaxFileName

protected: virtual IMPORT_C TDes &NameBuf();

Description

Gets a reference to the descriptor containing the filename passed to the constructor of this object.

Return value

TDes & A reference to the descriptor containing the filename.

protected: virtual IMPORT_C const TDesC &NameBufC() const;

Description

Gets a const reference to the descriptor containing the filename passed to the constructor of this object.

Return value

const TDesC & A const reference to the descriptor containing the filename.