Apache Portable Runtime
Functions
Directory Manipulation Functions
File Information

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)

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.
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines