Return to command index

read symbol value

command: ENTER <&symbol> [<prompt1>[ <prompt2>[ ...<promptN>]]]

Valid only in command procedures. Reads new value of a previously defined symbol (local or global set) from the input level which is passed at the command procedure call (the input level can be redirected by qualifiers, see also PROC_CALL?).

parameters

  • <&symbol> parameter type: symbol address
    Name of the symbol (previously defined) to store the result of input.
  • <prompt1>, <prompt2>, ..., <promptN> parameter type: string
    Text for prompting user input. The text parameters are separated by blanks.

qualifiers

  • /parent
    The input is read from the parent command level, no regard is payed to the local input level (see PROC_CALL?) passed.
  • /interactive
    The input is read from the main input level (see PROC_CALL?), no regard is payed to the local input level.

example

enter &NAME Q-FILE NAME:
prompts from within a command procedure "Q-FILE NAME: " and stores the received value in the symbol "NAME"