NAME
ost::DirTree -
A generic class to walk a hierarchical directory structure.
SYNOPSIS
#include <file.h>
Public Member Functions
DirTree (const char *prefix, unsigned maxdepth)
Construct a directory tree walk starting at the specified prefix.
DirTree (unsigned maxdepth)
Construct an un-opened directory tree of a known maximum depth.
virtual ~DirTree ()
void open (const char *prefix)
Open a directory tree path.
void close (void)
Close the directory path.
char * getPath (void)
Extract the next full pathname from the directory walk.
unsigned perform (const char *prefix)
This is used to step through the filter virtual for an entire
subtree, and is used for cases where a derived DirTree class
performs its primary operations through filter rather than
externally by calling getPath().
Protected Member Functions
virtual bool filter (const char *file, struct stat *ino)
Virtual method to filter results.
Detailed Description
A generic class to walk a hierarchical directory structure.
Author:
David Sugar <dyfet@ostel.com> Directory tree walking.
Constructor & Destructor Documentation
ost::DirTree::DirTree (const char * prefix, unsigned maxdepth)
Construct a directory tree walk starting at the specified prefix. A
maximum subdirectory depth is also specified.
Parameters:
prefix to start walk.
maxdepth subdirectory depth to examine.
ost::DirTree::DirTree (unsigned maxdepth)
Construct an un-opened directory tree of a known maximum depth.
Parameters:
maxdepth subdirectory subdirectory depth.
virtual ost::DirTree::~DirTree () [virtual]
Member Function Documentation
void ost::DirTree::close (void)
Close the directory path.
virtual bool ost::DirTree::filter (const char * file, struct stat * ino)
[protected, virtual]
Virtual method to filter results. Virtual override methods should call
baseclass method to assure . and .. names are stripped out.
Returns:
true if current filename is accepted.
Parameters:
file path to examine
ino info of type, date, etc.
char* ost::DirTree::getPath (void)
Extract the next full pathname from the directory walk. When returning
directories, a ’/’ is appended. The returned string is a buffer of
MAX_PATH size.
Returns:
path of next subdirectory entry or NULL.
void ost::DirTree::open (const char * prefix)
Open a directory tree path. Parameters:
prefix directory path to open.
unsigned ost::DirTree::perform (const char * prefix)
This is used to step through the filter virtual for an entire subtree,
and is used for cases where a derived DirTree class performs it’s
primary operations through filter rather than externally by calling
getPath(). Returns:
number of files and directories examined.
Parameters:
prefix directory path to examine.
Author
Generated automatically by Doxygen for GNU CommonC++ from the source
code.