PEEKBYTE
Syntax PEEKBYTE
(PEEKBYTE channel)
 
Explanation PEEKBYTE reports the ASCII value of the next character waiting on the input stream. The character is left in the input stream for subsequent READ, READCHAR, READLINE, READLIST, READQUOTE, or other input primitives.

A channel number may be entered as an optional input. If present, PEEKBYTE reads from that channel instead of reading from the input stream. This makes it easier to switch among multiple input streams.

Examples The following procedure ignores all input until a specific character is seen in the input stream.

TO WAIT.FOR :CHAR
     IF PEEKBYTE = :CHAR THEN STOP

     IGNORE READCHAR
     WAIT.FOR :CHAR
END

TopIndex