NAME

       al_fungetc - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              int al_fungetc(ALLEGRO_FILE *f, int c)

DESCRIPTION

       Ungets  a  single  byte  from a file.  Pushed-back bytes are not written to the file, only
       made available for subsequent reads, in reverse order.

       The number of pushbacks depends on the backend.  The standard I/O backend only  guarantees
       a single pushback; this depends on the libc implementation.

       For  backends that follow the standard behavior, the pushback buffer will be cleared after
       any seeking or writing; also calls to al_fseek(3alleg5) and al_ftell(3alleg5) are relative
       to  the  number  of  pushbacks.  If a pushback causes the position to become negative, the
       behavior of al_fseek(3alleg5) and al_ftell(3alleg5) are undefined.

SEE ALSO

       al_fgetc(3alleg5), al_get_errno(3alleg5)