Proc Reference > PQN Proc Commands > IN

Comment on this topic

Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

RealityV15.1Online Documentation (MoTW) Revision 7

IN command (Proc) (m618403+in.htm)

To

Reality

Version

Topic

Submitted by

Company

Location

Email address

Comment

 

 

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
145-98

145-98

Example 2

Input SIB Before SIB After
XYZ
145-98
XYZ

Example 3

Input SIB Before SIB After
3 456 789
XYZ
3^456^789

Example 4

Input SIB Before SIB After
RETURN
3^456^789

RealityV15.1 (MoTW) Revision 7Comment on this topic