Break (command) - Revision history

Gordon.dye: added function names to list of break targets

2019-05-18T02:09:38Z

added function names to list of break targets

← Older revision		Revision as of 02:09, 18 May 2019
Line 1:		Line 1:
	For disambiguation purposes, see also [[Break (Config)]].		For disambiguation purposes, see also [[Break (Config)]].

	The '''Break''' [[command]] causes the program to go into [[Step mode]] when a [[Variable\|variable]] value changes, or ~~the~~ specified [[line number]] is encountered. "BREAK variable-name" also implies "[[Display\|DISPLAY]] variable-name," so the new value of the variable will be displayed when a BREAK variable-name occurs.		The '''Break''' [[command]] causes the program to go into [[Step mode]] when a [[Variable\|variable]] value changes, or a specified [[line number]] or [[user defined function]] is encountered. "BREAK variable-name" also implies "[[Display\|DISPLAY]] variable-name," so the new value of the variable will be displayed when a BREAK variable-name occurs.

	Any line numbers specified must refer to an executable line. A line with an active operation such as a flow control, value assignment or input-output operation will break. Comments, data statements and DIM statements will not break.		Any line numbers specified must refer to an executable line. A line with an active operation such as a flow control, value assignment or input-output operation will break. Comments, data statements and DIM statements will not break.

Gordon.dye: /* Parameters */

2017-06-09T15:03:36Z

Parameters

← Older revision		Revision as of 15:03, 9 June 2017
Line 47:		Line 47:

	Adding the OFF parameter will clear (remove) the specified BREAK setting. ALL OFF will clear all currently active BREAK settings.		Adding the OFF parameter will clear (remove) the specified BREAK setting. ALL OFF will clear all currently active BREAK settings.

			===Conditional Breakpoints===
			Conditional breakpoints are not set with the BREAK command. They must be stored as a program statement in order to tell BR ''when'' to perform the condition test. The preferred command for a current break is "go step". An [[Execcute]] statement is used to execute the command:

			02000 ...
			02010 ! A will never exceed B if the preceding statements are correct
			02020 If A > B Then Execute "go step"
			02030 A = B
			02040 ...

			This will cause the program to stop before executing line 2020 so the programmer can identify which values and statements caused A to exceed B.
			----
			Another convenient programming technique is to use LINPUT to momentarily pause after displaying variable contents:

			02050 If {condition} then Print Partnum$ : Linput Z$

			If {condition} is true this will display the contents of Partnum$ and then pause for input into an unused variable. The programmer can then continue execution by pressing <enter> on the keyboard, enabling a scrolling effect as the program loops.

	<noinclude>		<noinclude>

Gordon.dye: /* Parameters */

2017-06-09T14:17:46Z

Parameters

← Older revision		Revision as of 14:17, 9 June 2017
Line 38:		Line 38:
	===Parameters===		===Parameters===

	The -p parameter specifies which [[program]] or programs the statement pertains to. If not specified, then the full BR path to the current program is stored as the program name search string. However ~~the~~ substring value ~~could~~ be used as a [[mask]] to apply to multiple program [[libraries]].		The -p parameter specifies which [[program]] or programs the statement pertains to. When -p is specified BR will first check the mask against the current program path. If it matches (or if -p is not specified) then the full BR path to the current program is stored as the program name search string. However a -p substring value that does not match the currently loaded program can be used as a [[mask]] to apply to multiple program [[libraries]].

	The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.		The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.

	The parameters "variable name", "function name", (and ~~also~~ array element) will cause the program to enter [[STEP mode]] when the specified ~~element~~ is changed. BREAK var-name also displays the variable assignment like [[Display (Command)\|DISPLAY]] does, except only the first element that changed in an array will be displayed.		The parameters "variable name", "function name", "array name" and "array element" will cause the program to enter [[STEP mode]] when the specified variable or array is changed. BREAK var-name also displays the variable assignment like [[Display (Command)\|DISPLAY]] does, except only the first element that changed in an array will be displayed.

	BEGIN will cause the program to enter step mode upon entry.		BEGIN will cause the program to enter step mode upon entry at the first line.

	Adding the OFF parameter will ~~return the program to [[RUN mode]] when~~ the specified ~~parameters (if any) are met~~. ALL OFF will ~~always return the program to RUN mode~~.		Adding the OFF parameter will clear (remove) the specified BREAK setting. ALL OFF will clear all currently active BREAK settings.

	<noinclude>		<noinclude>

Gordon.dye at 02:47, 6 July 2015

2015-07-06T02:47:19Z

← Older revision		Revision as of 02:47, 6 July 2015
Line 1:		Line 1:
	For disambiguation purposes, see also [[Break (Config)]].		For disambiguation purposes, see also [[Break (Config)]].

	The '''Break''' [[command]] causes the program to go into [[Step mode]] when a [[Variable\|variable]] value changes, or the specified [[line number]] is encountered. ~~Both~~ "BREAK variable-name" ~~and~~ "[[Display\|~~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\|variable]] value changes, or the specified [[line number]] is encountered. "BREAK variable-name" also implies "[[Display\|DISPLAY]] variable-name," so the new value of the variable will be displayed when a BREAK variable-name occurs.

			Any line numbers specified must refer to an executable line. A line with an active operation such as a flow control, value assignment or input-output operation will break. Comments, data statements and DIM statements will not break.

	==Examples==		==Examples==

Laura: /* Parameters */

2014-09-23T16:18:29Z

Parameters

← Older revision		Revision as of 16:18, 23 September 2014
Line 40:		Line 40:
	The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.		The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.

	The parameters "variable name", "function name", (and also array element) will cause the program to enter [[STEP mode]] when the specified element is changed. BREAK var-name also displays the variable assignment like [[~~DISPLAY~~ (Command)\|DISPLAY]] does, except only the first element that changed in an array will be displayed.		The parameters "variable name", "function name", (and also array element) will cause the program to enter [[STEP mode]] when the specified element is changed. BREAK var-name also displays the variable assignment like [[Display (Command)\|DISPLAY]] does, except only the first element that changed in an array will be displayed.

	BEGIN will cause the program to enter step mode upon entry.		BEGIN will cause the program to enter step mode upon entry.

Laura: /* Parameters */

2014-09-23T16:18:04Z

Parameters

← Older revision		Revision as of 16:18, 23 September 2014
Line 40:		Line 40:
	The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.		The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.

	The parameters "variable name", "function name", (and also array element) will cause the program to enter [[STEP mode]] when the specified element is changed. BREAK var-name also displays the variable assignment like [[DISPLAY (~~command~~)\|DISPLAY]] does, except only the first element that changed in an array will be displayed.		The parameters "variable name", "function name", (and also array element) will cause the program to enter [[STEP mode]] when the specified element is changed. BREAK var-name also displays the variable assignment like [[DISPLAY (Command)\|DISPLAY]] does, except only the first element that changed in an array will be displayed.

	BEGIN will cause the program to enter step mode upon entry.		BEGIN will cause the program to enter step mode upon entry.

Laura: /* Parameters */

2014-09-23T16:17:54Z

Parameters

← Older revision		Revision as of 16:17, 23 September 2014
Line 40:		Line 40:
	The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.		The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.

	The parameters "variable name", "function name", (and also array element) will cause the program to enter [[STEP mode]] when the specified element is changed. BREAK var-name also displays the variable assignment like [[DISPLAY]] does, except only the first element that changed in an array will be displayed.		The parameters "variable name", "function name", (and also array element) will cause the program to enter [[STEP mode]] when the specified element is changed. BREAK var-name also displays the variable assignment like [[DISPLAY (command)\|DISPLAY]] does, except only the first element that changed in an array will be displayed.

	BEGIN will cause the program to enter step mode upon entry.		BEGIN will cause the program to enter step mode upon entry.

Laura: /* Parameters */

2014-09-23T16:16:59Z

Parameters

← Older revision		Revision as of 16:16, 23 September 2014
Line 40:		Line 40:
	The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.		The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.

	The parameters "variable name", "function name", (and also array element) will cause the program to enter [[STEP mode]] when the specified element is changed.		The parameters "variable name", "function name", (and also array element) will cause the program to enter [[STEP mode]] when the specified element is changed. BREAK var-name also displays the variable assignment like [[DISPLAY]] does, except only the first element that changed in an array will be displayed.

	BEGIN will cause the program to enter step mode upon entry.		BEGIN will cause the program to enter step mode upon entry.

Laura: /* Parameters */

2014-05-08T16:31:35Z

Parameters

← Older revision		Revision as of 16:31, 8 May 2014
Line 38:		Line 38:
	The -p parameter specifies which [[program]] or programs the statement pertains to. If not specified, then the full BR path to the current program is stored as the program name search string. However the substring value could be used as a [[mask]] to apply to multiple program [[libraries]].		The -p parameter specifies which [[program]] or programs the statement pertains to. If not specified, then the full BR path to the current program is stored as the program name search string. However the substring value could be used as a [[mask]] to apply to multiple program [[libraries]].

	The parameters label: and line number will cause the program to enter [[STEP mode]] when the specified element is reached.		The parameters "label:" and "line number" will cause the program to enter [[STEP mode]] when the specified element is reached.

	The parameters variable name, function name, (and also array element) will cause the program to enter [[STEP mode]] when the specified element is changed.		The parameters "variable name", "function name", (and also array element) will cause the program to enter [[STEP mode]] when the specified element is changed.

	BEGIN will cause the program to enter step mode upon entry.		BEGIN will cause the program to enter step mode upon entry.

Laura: /* Syntax */

2014-05-08T16:30:08Z

Syntax

← Older revision		Revision as of 16:30, 8 May 2014
Line 19:		Line 19:

	==Syntax==		==Syntax==
	BREAK {[ [-p program name substring] {[<label>:[<clause>]]\|[<line number>[:<clause>]]\|[<variable name>]\|[<function name>]\|[BEGIN]} [OFF] ]\|[ALL OFF]}		BREAK {[ [-p program name substring] {[<[[Line Label\|label]]>:[<clause>]]\|[<[[line number]]>[:<clause>]]\|[<[[variable name]]>]\|[<[[function]] name>]\|[BEGIN]} [OFF] ]\|[ALL OFF]}

	[[File:Break.png]]		[[File:Break.png]]