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:

…&NLSREPL

 

 

 

 

 

„°LCHARS LSREPL

( °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

Operation

 

 

 

 

Type:

 

 

 

 

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:

„°LLRUN SST

( °is the left-shift of the Nkey).

Input/Output:

None

 

 

 

 

See also:

NEXT, SST↓

 

 

 

 

 

 

 

 

 

 

 

SST↓

Operation

 

 

 

 

Type:

 

 

 

 

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:

„°LLRUN SST↓

( °is the left-shift of the Nkey).

Input/Output:

None

 

 

 

 

Full Command and Function Reference 3-233