NAME

       al_fget_ustr - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              ALLEGRO_USTR *al_fget_ustr(ALLEGRO_FILE *f)

DESCRIPTION

       Read a string of bytes terminated with a newline or end-of-file.  The line terminator(s), if any, are in‐
       cluded in the returned string.

       On  success returns a pointer to a new ALLEGRO_USTR structure.  This must be freed eventually with al_us‐
       tr_free(3alleg5).  Returns NULL if an error occurred or if the end of file was  reached  without  reading
       any bytes.

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

SEE ALSO

       al_fgetc(3alleg5), al_fgets(3alleg5)

Allegro reference manual                                                                   al_fget_ustr(3alleg5)