Break (command): Difference between revisions
Jump to navigation
Jump to search
(Imported BREAK command page from old wiki) |
(Created and added new Syntax diagram) |
||
| Line 1: | Line 1: | ||
The '''Break''' command causes the program to go into [[step]] mode when a [[variable]] value changes, or the specified [[line number]] is encountered. Both "BREAK variable-name" and "[[Display (Command)|Display]] variable-name" may be active on the same variable concurrently. | The '''Break''' command causes the program to go into [[step]] mode when a [[variable]] value changes, or the specified [[line number]] is encountered. Both "BREAK variable-name" and "[[Display (Command)|Display]] variable-name" may be active on the same variable concurrently. | ||
==Examples== | |||
The following example will force the currently loaded program to go into [[step]] mode when the execution reaches line 1025: | |||
BREAK 1025 | |||
==Syntax== | ==Syntax== | ||
[[File:Break.png]] | |||
BREAK <nowiki>[ -p program-name-substring ] BEGIN [ OFF ] (break upon entry)</nowiki> | BREAK <nowiki>[ -p program-name-substring ] BEGIN [ OFF ] (break upon entry)</nowiki> | ||
BREAK <nowiki>[ -p program-name-substring ] variable-name [ OFF ]</nowiki> | BREAK <nowiki>[ -p program-name-substring ] variable-name [ OFF ]</nowiki> | ||
Revision as of 13:25, 27 December 2011
The Break command causes the program to go into step mode when a variable value changes, or the specified line number is encountered. Both "BREAK variable-name" and "Display variable-name" may be active on the same variable concurrently.
Examples
The following example will force the currently loaded program to go into step mode when the execution reaches line 1025:
BREAK 1025
Syntax
BREAK [ -p program-name-substring ] BEGIN [ OFF ] (break upon entry) BREAK [ -p program-name-substring ] variable-name [ OFF ] BREAK [ -p program-name-substring ] line[:clause] [ OFF ] BREAK [ -p program-name-substring ] label:[clause] [ OFF ] BREAK [ -p program-name-substring ] FNname [ OFF ] BREAK ALL OFF
This command causes a break to occur upon encountering the indicated conditions. When this happens the program enters step mode. If a program substring is given then the full program pathname is searched (case insensitive) for a matching substring before breaking.