al_open_directory - Allegro 5 API

       Opens  a  directory entry object.  You must call this before using al_read_directory(3alleg5) on an entry
       and you must call al_close_directory(3alleg5) when you no longer need it.

       Returns true on success.

       al_open_directory - Allegro 5 API

al_read_directory(3alleg5), al_close_directory(3alleg5)

Allegro reference manual                                                              al_open_directory(3alleg5)

              #include <allegro5/allegro.h>

              bool al_open_directory(ALLEGRO_FS_ENTRY *e)