Futurebasic/Language/Reference/stop

From Wikibooks, open books for an open world
Jump to navigation Jump to search

STOP[edit | edit source]

Syntax[edit | edit source]

STOP [string$]

Description[edit | edit source]

This statement interrupts program execution and displays a dialog box that shows the line number where the STOP statement appeared, and gives the user the option of continuing or stopping the program. If the optional string parameter is used, it will be displayed as a message in the alert. If no string parameter is used, FB displays the name of the file in which the STOP statement was used.

"Image was here"

If the user clicks the "Stop" button, FB calls your stop-event handling routine (if you've designated one using the ON STOP statement), and then your program ends. If the user clicks the "Continue" button, execution continues at the next statement following the STOP statement.

STOP is mainly useful as a debugging tool. It's not recommended for use in the "production" version of your program.

FB Lite behavior: When you use the "FB Lite" runtime, the STOP statement does not display a dialog, but instead prints a message in the Text Window indicating the line number where the STOP occurred. At that point, the program ends; the user does not have the option to continue.

See Also[edit | edit source]

END; ON BREAK; ON STOP