KEYIN

ANSI

The KEYIN instruction accepts input from the keyboard and may display data on the user's screen prior to accepting the input. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

data

Required. Any combination of previously defined Character String Variables, Numeric Variables, string or numeric Literals, string or numeric ARRAYs, individual array elements, VARLISTs of string or numeric variables, valid {ctrl} characters, or valid KEYIN list controls that is displayed.

;

Optional. A semicolon that prevents inhibits the normal output of a line feed upon statement termination.

Flags Affected: EOS, LESS, OVER, Function Key

Note the following:

1. Individual items within {data} are separated with commas. The list items may be continued on additional lines by ending each continued line with a colon (:).

2. If a FILEPI instruction is active, it is terminated.

3. A line feed, Function/Special key, System Interrupt, or Trapped Key terminates a KEYIN instruction.

4. If the *RV list control is used, several condition flags are set based on conditions encountered during the KEYIN. The EOS flag is set if a null entry was made with *RV in effect. The LESS flag is set if a timeout occurred with *T in effect. The OVER flag is set if the KEYIN was terminated with a Function/Special key, System Interrupt or Trapped Key.

5. Under PLBWIN, if an event is pending or a SETMODE *SCREEN=OFF statement is active, the KEYIN is skipped and the F31 flag is set.

6. When using the PL/B Web Server only basic support is available.

See Also: Literals and Control Characters, Variables, DISPLAY, List Controls (KEYIN and DISPLAY), List Controls (KEYIN Only), List Controls (Graphic Characters), Interactive I/O Instructions