UNGETC - place character in input stream.

Alternate Entry Name: .UNGET

Usage:

B:
   char = ungetc( [unit,] char );
/* C users use C "ungetc" */

Where:

unit
is the read unit to push the character back into. If not specified, "unit" defaults to the current read unit.
char
is a single ASCII character.

Description:

UNGETC associates "char" with the specified read unit, so that the next call to GETCHAR from that unit will return "char". An arbitrary number of characters may be "ungot".

If you use .SEEK to change your position in the file, all characters that have been "pushed back" by UNGETC are lost.

Copyright © 1996, Thinkage Ltd.