[ShCommands Return to command index]

== read symbol value ==

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

Valid only in [ShProcedures 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 [ShProcCall PROC_CALL]).

=== parameters ===

 * <&symbol> ''parameter type: symbol address''[[BR]]
   Name of the symbol (previously defined) to store the result of input.

 * <prompt1>, <prompt2>, ..., <promptN> ''parameter type: string''[[BR]]
   Text for prompting user input. The text parameters are separated by blanks.

=== qualifiers ===

 * /parent[[BR]]
   The input is read from the parent command level, no regard is payed to the local input level (see [ShProcCall PROC_CALL]) passed.

 * /interactive[[BR]]
   The input is read from the main input level (see [ShProcCall 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"