al_fgets(3)                                                        al_fgets(3)

NAME
       al_fgets - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              char *al_fgets(ALLEGRO_FILE *f, char * const buf, size_t max)


DESCRIPTION
       Read a string of bytes terminated with a newline or end-of-file into
       the buffer given.  The line terminator(s), if any, are included in the
       returned string.  A maximum of max-1 bytes are read, with one byte
       being reserved for a NUL terminator.

       Parameters:

       o f - file to read from

       o buf - buffer to fill

       o max - maximum size of buffer

       Returns the pointer to buf on success.  Returns NULL if an error
       occurred or if the end of file was reached without reading any bytes.

       See al_fopen(3) about translations of end-of-line characters.

SEE ALSO
       al_fget_ustr(3)

Allegro reference manual                                           al_fgets(3)