adoc/p_stream_nchars.adoc

   1 // stdio.asm:   WORD p_stream_nchars,'STREAM-NCHARS',fasm
   2
   3 anchor:p_stream_nchars[]
   4
   5 === Word: STREAM-NCHARS
   6 ....
   7 Data stack: ( stream -- n )
   8 ....
   9
  10 "STREAM-NCHARS" is a function word that scans ahead in the stream
  11 buffer for the next non-whitespace character, and returns its position
  12 relative to the end of the buffer. This is done without changing the
  13 stream (or filling it by reading the backing file).
  14