Apache Portable Runtime
Functions
Directory Manipulation Functions

Functions

apr_status_t apr_dir_open (apr_dir_t **new_dir, const char *dirname, apr_pool_t *pool)
 
apr_status_t apr_dir_close (apr_dir_t *thedir)
 
apr_status_t apr_dir_read (apr_finfo_t *finfo, apr_int32_t wanted, apr_dir_t *thedir)
 
apr_status_t apr_dir_rewind (apr_dir_t *thedir)
 

Detailed Description

Function Documentation

apr_status_t apr_dir_close ( apr_dir_t thedir)

close the specified directory.

Parameters
thedirthe directory descriptor to close.
apr_status_t apr_dir_open ( apr_dir_t **  new_dir,
const char *  dirname,
apr_pool_t pool 
)

Open the specified directory.

Parameters
new_dirThe opened directory descriptor.
dirnameThe full path to the directory (use / on all systems)
poolThe pool to use.
apr_status_t apr_dir_read ( apr_finfo_t finfo,
apr_int32_t  wanted,
apr_dir_t thedir 
)

Read the next entry from the specified directory.

Parameters
finfothe file info structure and filled in by apr_dir_read
wantedThe desired apr_finfo_t fields, as a bit flag of APR_FINFO_ values
thedirthe directory descriptor returned from apr_dir_open
Remarks
No ordering is guaranteed for the entries read.
Note
If APR_INCOMPLETE is returned all the fields in finfo may not be filled in, and you need to check the finfo->valid bitmask to verify that what you're looking for is there. When no more entries are available, APR_ENOENT is returned.
apr_status_t apr_dir_rewind ( apr_dir_t thedir)

Rewind the directory to the first entry.

Parameters
thedirthe directory descriptor to rewind.