INQUIRE command

Syntax: | `INQUIRE 'your message' v1 { v2 ... } INQUIRE\YESNO 'your message' answer`
Qualifiers: | `\YESNO`

This command can only be used in script command files.

A small form will be opened displaying `'your message'` string.

If the variables `v1, v2,` etc. exist already, the user is expected to provide the correct number and type of values corresponding to those variable names. These values are entered into an edit box provided on the form. If any of the variables do not pre-exist, they are assumed to be scalars. If you do not enter anything into the edit box, the pre-existing variables are left unchanged.

If the `\YESNO` qualifier is used, no edit box will be provided, but `'your message'` will be displayed and when the user clicks on the `YES` (`NO`) key the text string `YES` (`NO`) will be returned in the `answer` text variable. Since a single text variable is always expected, the `answer` variable does not need to pre-exist.

If the user clicks on the `Stop all scripts` button, the current command script will be stopped and any calling scripts will also be stopped.

Example

     INQUIRE\YESNO 'Do you want to continue?' TXT
     IF EQS(UCASE(TXT),'YES') THEN    ! valid response
      ...
      GOTO CONTINUE                   ! continue with the macro
     ENDIF
     ...
     CONTINUE:
     ...

Example

     VECTOR X 1
     INQUIRE 'Enter a vector of length 5 and a scalar' X S

The first command defines `X` to be a vector of length `1`. The `INQUIRE` command will display the message and wait for you to type in a vector set and a single value. For example: `[0;1;3.5;-4;100] 10.3`