READCHARS

Synopsis
READCHARS number
RCS number
Description

Reads number characters from the read stream and outputs those characters as a word. If number is larger than the number of characters remaining in the read stream, then READCHARS outputs the rest of the read stream. If the read stream is a file and there are no unread characters in the file, then READCHARS outputs the empty list (not the empty word).

If the read stream is the Commander, then READCHARS always outputs the empty list.

Backslash, vertical bar, and tilde characters have no special meaning in this context.

Example
OPENWRITE "dummy.fil
SETWRITE "dummy.fil
PRINT "Hello
SETWRITE []
CLOSE "dummy.fil

OPENREAD "dummy.fil
SETREAD "dummy.fil
SHOW READCHARS 5
Hello
SETREAD []
CLOSE "dummy.fil

SourceForge.net Logo