# prompt statement

The prompt statement in a macro prompts
the user with a specified text string. The user is then given the
option to either continue (by entering c, or
stopping the process (by entering q). No other
characters are allowed.

## Syntax

```
prompt {prompt.text}
```

## Parameter(s)

| prompt.text | Displays text that requires user input. This option has the same conventions and syntax as the display command. |
| --- | --- |

## Example(s)

```
mactest

001 n
002 display Starting file save
003 prompt Insert first reel
004 save (fts
```
In the example above, after displaying `Starting file save`, the user is prompted with:

```
Insert first reel -- Quit/Continue (q/c)?
```
If a c is entered, the save command is executed. The macro stops immediately if
a q is provided.

Note: Only c or q are accepted by the prompt command.

---
Source: https://d3codex.com/tcl/prompt-statement/ - part of the D3Codex reference.
