Scroll to navigation

ost::DirTree(3) Library Functions Manual ost::DirTree(3)

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, unsignedmaxdepth)

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 (unsignedmaxdepth)

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.
Sun Dec 29 2013 GNU CommonC++