Reference Guide
Full Command and Function Reference 3-233
Note that BUFLEN also clears the above-mentioned framing, overrun, and overflow errors.
Therefore, SRECV cannot detect an input-buffer overflow after BUFLEN is executed, unless
more characters were received after BUFLEN was executed (causing the input buffer to overflow
again). SRECV also cannot detect framing and UART overrun errors cleared by BUFLEN. To
find where the data error occurred, save the number of characters returned by BUFLEN (which
gives the number of “good” characters received), because as soon as the error is cleared, new
characters can enter the input buffer.
Access: …µ
SRECV
Flags: I/O Device (–33), I/O Device for Wire (–78)
Input/Output:
Level 1/Argument 1 Level 2/Item 1 Level 1/Item 2
n
→
'string'
0/1
Example: If 10 good bytes were received followed by a framing error, then an SRECV command told to
read 10 bytes would not indicate an error. Only when SRECV tries to read the byte that caused the
framing error does it return a 0. Similarly, if the input buffer overflowed, SRECV would not
indicate an error until it tried to read the first byte that was lost due to the overflow.
See also: BUFLEN, CLOSEIO, OPENIO, SBRK, STIME, XMIT
SREPL
Type: Command
Description: Find and replace: Finds and replaces a string in a given text object. You supply the following
inputs:
Level 3/argument 1: the string to search.
Level 2/argument 2: the string to find.
Level 1/argument 3: the string to replace it with.
Access: …&NL
SREPL
„°L
CHARS
L
SREPL
( °is the left-shift of the Nkey).
Input/Output:
Level 3/Argument 1 Level 2/Argument 2 Level 1/Argument 3 Level 1/Item 1
'string'
'string'
'string'
→
'string'
See also: REPL
SST
Type: Operation
Description: Execute Program Step Operation: Returns and executes the next step of a program. If the next
step is a subroutine, executes the subroutine in a single step.
SST is not programmable.
Access: „°LL
RUN SST
( °is the left-shift of the Nkey).
Input/Output: None
See also: NEXT, SST↓
SST↓
Type: Operation
Description: Execute Subroutine Step Operation: Returns and executes the next step of a program or
subroutine. If the next step is a subroutine, returns and executes the first step of the subroutine.
SST↓ is not programmable.
Access: „°LL
RUN SST
↓ ( °is the left-shift of the Nkey).
Input/Output: None