ACE  6.3.3
Public Member Functions | Private Attributes | List of all members
ACE_Dirent Class Reference

Define a portable C++ directory-entry iterator based on the POSIX API. More...

#include <Dirent.h>

Public Member Functions

 ACE_Dirent (void)
 Default constructor. More...
 
 ACE_Dirent (const ACE_TCHAR *dirname)
 Constructor calls opendir() More...
 
int open (const ACE_TCHAR *filename)
 
 ~ACE_Dirent (void)
 Destructor calls closedir(). More...
 
void close (void)
 Closes the directory stream and frees the ACE_DIR structure. More...
 
ACE_DIRENTread (void)
 
int read (struct ACE_DIRENT *entry, struct ACE_DIRENT **result)
 
long tell (void)
 
void seek (long loc)
 
void rewind (void)
 

Private Attributes

ACE_DIRdirp_
 Pointer to the directory stream. More...
 

Detailed Description

Define a portable C++ directory-entry iterator based on the POSIX API.

Constructor & Destructor Documentation

ACE_Dirent::ACE_Dirent ( void  )
inline

Default constructor.

ACE_Dirent::ACE_Dirent ( const ACE_TCHAR dirname)
inlineexplicit

Constructor calls opendir()

ACE_Dirent::~ACE_Dirent ( void  )
inline

Destructor calls closedir().

Member Function Documentation

void ACE_Dirent::close ( void  )
inline

Closes the directory stream and frees the ACE_DIR structure.

int ACE_Dirent::open ( const ACE_TCHAR filename)
inline

Opens the directory named by filename and associates a directory stream with it.

ACE_DIRENT * ACE_Dirent::read ( void  )
inline

Returns a pointer to a structure representing the directory entry at the current position in the directory stream to which dirp refers, and positions the directory stream at the next entry, except on read-only filesystems. It returns a NULL pointer upon reaching the end of the directory stream, or upon detecting an invalid location in the directory. read() shall not return directory entries containing empty names. It is unspecified whether entries are returned for dot or dot-dot. The pointer returned by read() points to data that may be overwritten by another call to read() on the same directory stream. This data shall not be overwritten by another call to read() on a different directory stream. read() may buffer several directory entries per actual read operation; read() marks for update the st_atime field of the directory each time the directory is actually read.

int ACE_Dirent::read ( struct ACE_DIRENT entry,
struct ACE_DIRENT **  result 
)
inline

Has the equivalent functionality as read() except that an entry and result buffer must be supplied by the caller to store the result.

void ACE_Dirent::rewind ( void  )
inline

Resets the position of the directory stream to the beginning of the directory. It also causes the directory stream to refer to the current state of the corresponding directory, as a call to opendir() would.

void ACE_Dirent::seek ( long  loc)
inline

Sets the position of the next read() operation on the directory stream. The new position reverts to the position associated with the directory stream at the time the tell() operation that provides loc was performed. Values returned by tell() are good only for the lifetime of the ACE_DIR pointer from which they are derived. If the directory is closed and then reopened, the telldir() value may be invalidated due to undetected directory compaction. It is safe to use a previous telldir() value immediately after a call to opendir() and before any calls to readdir.

long ACE_Dirent::tell ( void  )
inline

Returns the current location associated with the directory stream.

Member Data Documentation

ACE_DIR* ACE_Dirent::dirp_
private

Pointer to the directory stream.


The documentation for this class was generated from the following files: