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