User`s manual

.READSTR
5-10
5
.READSTR
Name
.READSTR - Read string into variable-length buffer
Code
$0003
Description
.READSTR is used to read a string of characters from the default
input port into a buffer. On entry, the Þrst byte in the buffer
indicates the maximum number of characters that can be placed in
the buffer. The buffer size should at least be equal to that number+2.
The maximum number of characters that can be placed in a buffer
is 254 characters. On exit, the count byte indicates the number of
characters in the buffer. Input terminates when a
<CR> is received.
A null character appears in the buffer, although it is not included in
the string count. All printable characters are echoed to the default
output port. The
<CR> is not echoed. Some control character
processing is done:
All other control characters are ignored
Entry Conditions
R03: 32-bit address of input buffer
Exit Conditions Different From Entry
The count byte contains the number of bytes in the buffer.
^G Bell Echoed
^X Cancel line Line is erased
^H Backspace Last character is erased
<DEL> Same as backspace Last character is erased
<LF> Line Feed Echoed
<CR> Carriage Return Terminates input