Utility class representing an open directory. More...
#include <glibmm/fileutils.h>
List of all members.
Detailed Description
Utility class representing an open directory.
It's highly recommended to use the iterator interface. With iterators, reading an entire directory into a STL container is really easy:
- Note:
- The encoding of the directory entries isn't necessarily UTF-8. Use Glib::filename_to_utf8() if you need to display them.
Member Typedef Documentation
Constructor & Destructor Documentation
Opens a directory for reading.
The names of the files in the directory can then be retrieved using read_name().
- Parameters:
-
| path | The path to the directory you are interested in. |
- Exceptions:
-
Closes the directory and deallocates all related resources.
Member Function Documentation
Get the begin of an input iterator sequence.
- Returns:
- An input iterator pointing to the first directory entry.
void Glib::Dir::close |
( |
|
) |
|
Closes the directory and deallocates all related resources.
Note that close() is implicitely called by ~Dir(). Thus you don't need to call close() yourself unless you want to close the directory before the destructor runs.
Get the end of an input iterator sequence.
- Returns:
- An input iterator pointing behind the last directory entry.
Retrieves the name of the next entry in the directory.
The '.'
and '..'
entries are omitted.
- Returns:
- The entry's name or
""
if there are no more entries.
- See also:
- begin(), end()
void Glib::Dir::rewind |
( |
|
) |
|
Resets the directory.
The next call to read_name() will return the first entry again.