On a system such as OS/2 or Windows, each volume _is_ a root directory, and a root directory iterator return the exact same entities as a volume iterator. However, on ssystems like Unix, there can be many volumes but only one root directory, so the root directory iterator only returns the single root directory "/".
This class is designed to mimic a C++ pointer, similar to the iterator
classes in the ANSI/ISO C++ draft standard. When the C++ Standard Library
is available, IDirectoryIterator will inherit from
input_iterator
Typical usage is as follows:
for (IRootDirectoryIterator aDirectory; aDirectory; aDirectory++)
{
DoSomething( *aDirectory );
}
Constructors & DestructorUse these methods to construct, copy, and assign root directory iterator objects.
![]() |
public:
virtual ~IRootDirectoryIterator()
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
IRootDirectoryIterator()
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
public:
IRootDirectoryIterator(const IRootDirectoryIterator& copy)
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
IRootDirectoryIterator& operator =( const IRootDirectoryIterator& copy )
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
Comparison and validation operators.Use these methods to compare root directory iterators or to validate them.
![]() |
public:
bool operator !=(const IRootDirectoryIterator& other) const
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
bool operator ==(const IRootDirectoryIterator& other) const
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
operator bool() const
This member function is often used in the termination condition of a for or while loop. When operator bool returns false, there are no more root directories over which to iterate.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
Standard iteration functionsUse these iteration operators to iterator through the directories.
![]() |
public:
IDirectory operator *() const
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
Proceeds to the next root directory in the iteration.
public:
IRootDirectoryIterator& operator ++()
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
public:
IRootDirectoryIterator operator ++(int)
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
IDirectory* operator ->()
anIterator->name()
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
Miscellaneous Members![]() |
public:
static const IRootDirectoryIterator& end()
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |