(C) 1998 AROS - The Amiga Research OS


NAME
#include <proto/dos.h>

LONG UnGetC (file , character)

LOCATION
In DOSBase at offset 53

SYNOPSIS
BPTR file
LONG character

FUNCTION
Push a character back into a read filehandle. If you've read a character from that file you may always push at least 1 character back. UnGetC(file,-1) ungets the last character read. This also works for EOF.

INPUTS
file
Filehandle you've read from.
character
Character to push back or EOF.

RESULT
!=0 if all went well, 0 if the character couldn't be pushed back. IoErr() gives additional information in that case.

EXAMPLE

SEE ALSO
FGetC(), IoErr()

NOTES

BUGS

INTERNALS

HISTORY
20.10.1998 hkiel
Amiga Research OS
27.01.1997 ldp
Polish
09.12.1996 aros
Added empty templates for all missing functions

Moved #include's into first column

24.10.1996 aros
Use the official AROS macros over the __AROS versions.
13.08.1996 digulla
Replaced <dos/dosextens.h> by "dos_intern.h" or added "dos_intern.h" Replaced __AROS_LA by __AROS_LHA
01.08.1996 digulla
Added standard header for all files
28.07.1996 digulla
Initial revision
28.07.1996 digulla
First CVS version of AROS