Class TParsePtrC

TParsePtrC

Support

Supported from 5.0

Description

Parses (but cannot modify) filenames using less space on the stack than TParse. Stores a reference to a filename, unlike TParse, which uses a 256 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. Note that because the filename cannot be modified through this class, the base class functions PopDir() and AddDir() cannot be called, otherwise a panic will occur.

Derivation

TParseBase Base class for file name parsing TParsePtrC Parses (but cannot modify) filenames using less space on the stack than TParse

Defined in TParsePtrC:
TParsePtrC()

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

See also:

• TParse
• Using TParse

TParsePtrC(const TDesC& aName);

Description

Constructor with a constant reference to a filename. The filename is parsed and if this fails, a panic occurs. The filename cannot be modified using this class.

Parameters

const TDesC& aName Constant reference to the filename to be parsed. On return contains the fully parsed filename. If a file and extension are specified, they may both contain wildcards. The maximum length is 256 characters.