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:

thedir

the 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_dir

The opened directory descriptor. Parameters: dirname  The full path to the directory (use / on all systems) Parameters: pool  The 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:

finfo

the file info structure and filled in by apr_dir_read Parameters: wanted  The desired apr_finfo_t fields, as a bit flag of APR_FINFO_ values Parameters: thedir  the 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:

thedir

the directory descriptor to rewind.