Skip Navigation Links
Skip Navigation LinksHome > ZipArchive > How to Use > API Documentation

ZipArchiveLib::CDirEnumerator Class Reference

#include <DirEnumerator.h>

List of all members.

Public Member Functions

LPCTSTR GetCurrentDirectory () const
LPCTSTR GetDirectory () const
bool IsRecursive () const
bool Start (CFileFilter &filter)

Protected Member Functions

 CDirEnumerator (LPCTSTR lpszDirectory, bool bRecursive=true)
virtual void EnterDirectory ()
virtual void ExitDirectory ()
virtual void OnEnumerationBegin ()
virtual void OnEnumerationEnd (bool bResult)
virtual bool Process (LPCTSTR lpszPath, const CFileInfo &info)=0

Detailed Description

A base class for processing multiple files in a directory. It provides a directory enumeration functionality.


Constructor & Destructor Documentation

ZipArchiveLib::CDirEnumerator::CDirEnumerator ( LPCTSTR  lpszDirectory,
bool  bRecursive = true 
) [inline, protected]

Initializes a new CDirEnumerator object.

Parameters:
lpszDirectoryA directory to process.
bRecursiveThe value indicating whether the subfolders of lpszDirectory should be processed recursively.
See also:
GetDirectory
IsRecursive

Member Function Documentation

virtual void ZipArchiveLib::CDirEnumerator::EnterDirectory (  ) [inline, protected, virtual]

This method is called when an enumeration process enters a new directory.

See also:
GetCurrentDirectory
ExitDirectory
virtual void ZipArchiveLib::CDirEnumerator::ExitDirectory (  ) [inline, protected, virtual]

This method is called when an enumeration process exits a directory.

See also:
GetCurrentDirectory
EnterDirectory
LPCTSTR ZipArchiveLib::CDirEnumerator::GetCurrentDirectory (  ) const [inline]

Returns the directory being currently processed.

Returns:
The directory being currently processed.
LPCTSTR ZipArchiveLib::CDirEnumerator::GetDirectory (  ) const [inline]

Returns the directory being enumerated.

Returns:
The directory being enumerated (root).
See also:
CDirEnumerator::CDirEnumerator
bool ZipArchiveLib::CDirEnumerator::IsRecursive (  ) const [inline]

Returns the value indicating whether the subfolders of the root directory are processed recursively.

Returns:
true, if the enumeration process is recursive; false otherwise.
See also:
CDirEnumerator::CDirEnumerator
virtual void ZipArchiveLib::CDirEnumerator::OnEnumerationBegin (  ) [inline, protected, virtual]

This method is called at the beginning of the enumeration process.

See also:
OnEnumerationEnd
virtual void ZipArchiveLib::CDirEnumerator::OnEnumerationEnd ( bool  bResult ) [inline, protected, virtual]

This method is called at the end of the enumeration process.

Parameters:
bResultIt is set to false, if the Process method returned false (the enumeration was aborted). Otherwise, it is set to true.
See also:
OnEnumerationBegin
virtual bool ZipArchiveLib::CDirEnumerator::Process ( LPCTSTR  lpszPath,
const CFileInfo info 
) [protected, pure virtual]

Override this method to perform file processing while enumerating directories. This method is not called for directories, but for files only.

Parameters:
lpszPathThe full path to the current file.
infoA structure containing an information about the current file.
Returns:
Return true to continue the enumeration. When you return false, the enumeration is aborted.
See also:
CFileFilter::Evaluate
bool ZipArchiveLib::CDirEnumerator::Start ( CFileFilter filter )

Starts the enumeration process. Calls CFileFilter::Evaluate method for every file or directory found. If CFileFilter::Evaluate returns true, the file is processed by the Process method.

Parameters:
filterA filter that decides which directories and/or files should be processed and which should not.
Returns:
false, if the process was aborted (the Process method returned false); true otherwise.
See also:
CFileFilter::Evaluate

The documentation for this class was generated from the following file:
Back To Top Up