TParsePtr Class Reference

#include <f32file.h>

class TParsePtr : public TParseBase

Inherits from

Detailed 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.

See also: TParse TFileName

Constructor & Destructor Documentation

TParsePtr ( TDes & )

IMPORT_CTParsePtr(TDes &aName)

Constructor taking a reference to a filename.

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

panic
FSCLIENT 24 if the the specified name fails to parse.

See also: KMaxFileName

ParameterDescription
aNameReference 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.

Member Function Documentation

NameBuf ( )

IMPORT_C TDes &NameBuf()[protected, virtual]

Reimplemented from TParseBase::NameBuf()

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

Returns: A reference to the descriptor containing the filename.

NameBufC ( )

IMPORT_C const TDesC &NameBufC()const [protected, virtual]

Reimplemented from TParseBase::NameBufC()const

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

Returns: A const reference to the descriptor containing the filename.