adoc/p_clear_stream.adoc

   1 // stdio.asm:   WORD p_clear_stream,'CLEAR-STREAM',fasm
   2
   3 anchor:p_clear_stream[]
   4
   5 === Word: CLEAR-STREAM
   6
   7 ....
   8 Data stack: ( stream -- )
   9 ....
  10
  11 "CLEAR-STREAM" is a function word that discards whatever is currently
  12 remaining in the buffer for the stream, so that a subsequent read will
  13 pull in more data from its source.
  14
  15 See also <<p_read_stream_char,READ-STREAM-CHAR>>.