TParsePtrC Class Reference

#include <f32file.h>

class TParsePtrC : public TParseBase

Inherits from

Detailed 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 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. Note that because the filename cannot be modified through this class, the base class functions PopDir() and AddDir() cannot be called, because a panic will be raised.

See also: TParse TFileName

Constructor & Destructor Documentation

TParsePtrC ( const TDesC & )

IMPORT_CTParsePtrC(const TDesC &aName)

Constructor taking a constant reference to a filename.

The filename is parsed and if this fails, a panic is raised. Note that the filename cannot be modified using this class.

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

See also: KMaxFileName

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