.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "al_read_directory" "3" "" "Allegro reference manual"
.SH NAME
al_read_directory \- Allegro 5 API
.SH SYNOPSIS
.IP
.EX
#include \f[B]<allegro5/allegro.h>\f[R]

ALLEGRO_FS_ENTRY *al_read_directory(ALLEGRO_FS_ENTRY *e)
.EE
.SH DESCRIPTION
Reads the next directory item and returns a filesystem entry for it.
.PP
Returns NULL if there are no more entries or if an error occurs.
Call al_destroy_fs_entry(3) on the returned entry when you are done with
it.
.PP
This function will ignore any files or directories named \f[CR].\f[R] or
\f[CR]..\f[R] which may exist on certain platforms and may signify the
current and the parent directory.
.SH SEE ALSO
al_open_directory(3), al_close_directory(3)