Stops the program's execution and returns to the command prompt.
- An optional message to print before stopping.
- The x coordinate of the upper left corner to start printing.
- The y coordinate of the upper left corner to start printing.
- The color to use for the text.
stop() function stops the program at the point where the function is called, returning to the command prompt. This is similar to pressing the Escape key at a specific point in the code.
Note that the format of the optional arguments is identical to the more-familiar print(). This can be useful for explaining why the app has exited, especially if combined with information from trace().
If your program uses the game loop, you can resume execution of the program using the resume command. This does not resume from the call to
stop(). Instead, it starts the next loop iteration with a call to _update(). If your program does not use the game loop, resume raises an error.
v = 1 function _update() v += 1 if (v % 5) == 0 then stop() end end function _draw() cls() print(v, 0, 0, 8) end
Running this program stops when
v is a multiple of 5. From the command prompt:
> print(v) 5 > resume
The program stops again at the next multiple of 5:
> print(v) 10