IN
Prompts for input from the terminal and place it in the secondary input buffer. The secondary input buffer is selected as the active buffer input.
Syntax
IN{char}
Syntax Elements
char An optional prompt character. If included, it remains in effect until reset with an IBN, IBP, IN, IP or PROMPT command.
If char is not included, the prompt defaults to the last prompt character used or to a colon (:).
Comment
Because the secondary input buffer has fallen into disuse, the use of the IN command in general programming is not recommended.
Operation
The current contents of the secondary input buffer are destroyed and the buffer pointer is set to the beginning, prior to placing the data in the buffer.
Leading and trailing blanks are removed and embedded blanks are replaced with a single attribute mark.
Use the IBN command if you want to retain the blanks input at the terminal and treat the entered text as a single parameter.
Pressing RETURN only in response to an input prompt creates a null parameter.
The buffer pointer is positioned at the beginning of the buffer after an IN command. The secondary input buffer is selected as the active input buffer. It remains active until an RI, S(n), or MV %n source command is executed.
Example 1
|
Input |
SIB Before |
SIB After |
|---|---|---|
|
|
|
|
Example 2
|
Input |
SIB Before |
SIB After |
|---|---|---|
|
|
|
|
Example 3
|
Input |
SIB Before |
SIB After |
|---|---|---|
|
|
|
|
Example 4
|
Input |
SIB Before |
SIB After |
|---|---|---|
|
RETURN |
|
|