UniBasic Commands Reference - Rocket Software

GET
Syntax
GET[X] var[,length] [SETTING count.var] FROM line.expr [UNTIL term.expr]
[RETURNING term.var] [WAITING seconds]
[THEN statements |ELSE statements]
Description
The UniBasic GET command receives unprompted input from an attached line.
UniData accepts all control characters, including the carriage return and line feed as
input characters. All data read from the attached line is placed in var. GET supports
multibyte languages.
Performance of the GET statement varies according to the termination conditions
specified, and whether the THEN or ELSE clauses are specified.
Input from the attached line is terminated in four ways:
UniData has read the number of characters specified in length.
After a single character is read (when length and UNTIL are not coded).
When any character you specify in term.exp is encountered in input.
When UniData reads the record mark character, @RM, and the number of
seconds has elapsed.
Note: UniData never executes the ELSE clause if you include UNTIL without
WAITING or length.
If you code the WAITING clause, UniData executes the ELSE clause only after the
number of seconds specified for timeout. If the input is terminated for any other
reason, UniData executes the THEN clause.
In special cases, UniData executes the ELSE clause if the line has not been attached
before executing the GET statement.
1-288 UniBasic Commands Reference