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 it's 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.