On GoSub - Revision history

Laura: /* Syntax */

2014-05-05T15:44:09Z

Syntax

← Older revision		Revision as of 15:44, 5 May 2014
Line 10:		Line 10:

	===Syntax===		===Syntax===
	ON <numeric expression> GOSUB <line ref>[,...] [NONE <line ref>] [<error condition> <line ref>][,...]		ON <[[numeric expression]]> [[GOSUB]] <[[line ref]]>[,...] [NONE <[[line ref]]>] [<[[error condition]]> <[[line ref]]>][,...]

	[[Image:Ongosub.png\|800px]]		[[Image:Ongosub.png\|800px]]

Laura: /* Syntax */

2014-04-28T16:17:12Z

Syntax

← Older revision		Revision as of 16:17, 28 April 2014
Line 10:		Line 10:

	===Syntax===		===Syntax===
	ON <numeric expression> GOSUB {<line ref>,} [NONE <line ref>] [{<error condition> <line ref>,}]		ON <numeric expression> GOSUB <line ref>[,...] [NONE <line ref>] [<error condition> <line ref>][,...]

	[[Image:Ongosub.png\|800px]]		[[Image:Ongosub.png\|800px]]

Laura: /* Syntax */

2014-04-24T19:08:46Z

Syntax

← Older revision		Revision as of 19:08, 24 April 2014
Line 10:		Line 10:

	===Syntax===		===Syntax===
			ON <numeric expression> GOSUB {<line ref>,} [NONE <line ref>] [{<error condition> <line ref>,}]

	[[Image:Ongosub.png\|800px]]		[[Image:Ongosub.png\|800px]]

John: moved On Gosub to On GoSub over redirect

2014-02-26T15:32:21Z

moved On Gosub to On GoSub over redirect

← Older revision	Revision as of 15:32, 26 February 2014
(No difference)

Laura: /* Parameters */

2013-07-30T21:28:07Z

Parameters

← Older revision		Revision as of 21:28, 30 July 2013
Line 17:		Line 17:

	===Parameters===		===Parameters===
	ON GOSUB has two required parameters. "Numeric-expression" is the numeric expression -a constant, variable, relational expression, or function -that the system is to evaluate~~. "Line-ref" is the name or number of the line to which control transfers when the value of the numeric expression is matched to the position order of the line-ref~~.		ON GOSUB has two required parameters. "Numeric-expression" is the numeric expression -a constant, variable, relational expression, or function -that the system is to evaluate.

	The optional "NONE line-ref" parameter allows you to specify the line that control should go to when the value of the numeric expression does not fall into the indicated range. This branch is treated as a GOSUB branch rather than an error-processing branch. The branched-to subroutine must end with a [[RETURN]] statement. ON GOSUB also provides error processing with the optional "error-cond line-ref" parameter. See [[Error Conditions]] for more information.		"Line-ref" is the name or number of the line to which control transfers when the value of the numeric expression is matched to the position order of the line-ref.

			The optional "NONE line-ref" parameter allows you to specify the line that control should go to when the value of the numeric expression does not fall into the indicated range. This branch is treated as a GOSUB branch rather than an error-processing branch. The branched-to subroutine must end with a [[RETURN]] statement.

			ON GOSUB also provides error processing with the optional "error-cond line-ref" parameter. See [[Error Conditions]] for more information.

	===Technical Considerations===		===Technical Considerations===

Laura: /* Parameters */

2013-01-24T18:53:08Z

Parameters

← Older revision		Revision as of 18:53, 24 January 2013
Line 17:		Line 17:

	===Parameters===		===Parameters===
	ON GOSUB has two required parameters. "~~Num~~-~~expr~~" is the numeric expression -a constant, variable, relational expression, or function -that the system is to evaluate. "Line-ref" is the name or number of the line to which control transfers when the value of the numeric expression is matched to the position order of the line-ref.		ON GOSUB has two required parameters. "Numeric-expression" is the numeric expression -a constant, variable, relational expression, or function -that the system is to evaluate. "Line-ref" is the name or number of the line to which control transfers when the value of the numeric expression is matched to the position order of the line-ref.

	The optional "NONE line-ref" parameter allows you to specify the line that control should go to when the value of the numeric expression does not fall into the indicated range. This branch is treated as a GOSUB branch rather than an error-processing branch. The branched-to subroutine must end with a [[RETURN]] statement. ON GOSUB also provides error processing with the optional "error-cond line-ref" parameter. See [[Error Conditions]] for more information.		The optional "NONE line-ref" parameter allows you to specify the line that control should go to when the value of the numeric expression does not fall into the indicated range. This branch is treated as a GOSUB branch rather than an error-processing branch. The branched-to subroutine must end with a [[RETURN]] statement. ON GOSUB also provides error processing with the optional "error-cond line-ref" parameter. See [[Error Conditions]] for more information.

Laura at 18:39, 24 January 2013

2013-01-24T18:39:00Z

← Older revision		Revision as of 18:39, 24 January 2013
Line 1:		Line 1:
	The '''On Gosub''' [[statement]] evaluates a numeric expression, then transfers program control to a subroutine according to the expression's value.		The '''On Gosub''' (ON GOS) [[statement]] evaluates a numeric expression, then transfers program control to a subroutine according to the expression's value.

	===Comments and Examples===		===Comments and Examples===

Laura: /* Syntax */

2013-01-24T18:36:45Z

Syntax

← Older revision		Revision as of 18:36, 24 January 2013
Line 10:		Line 10:

	===Syntax===		===Syntax===
	[[Image:Ongosub.png]]		[[Image:Ongosub.png\|800px]]

	===Defaults===		===Defaults===

Laura: Created page with "The '''On Gosub''' statement evaluates a numeric expression, then transfers program control to a subroutine according to the expression's value. ===Comments and Examples=..."

2013-01-24T18:25:14Z

Created page with "The '''On Gosub''' statement evaluates a numeric expression, then transfers program control to a subroutine according to the expression's value. ===Comments and Examples=..."

New page

The '''On Gosub''' [[statement]] evaluates a numeric expression, then transfers program control to a subroutine according to the expression's value.

===Comments and Examples===
GOSUB matches the rounded integer value of an expression to its corresponding line-ref. If the value is 3.25, for example, program control transfers to the subroutine that begins at the line indicated in the third line-ref.

In the following example, control goes to line 640 when T is 0, to line 740 when T is 4, and to line 840 when T is 6. When T/X + 1 rounds to a number less than one or greater than three, control goes to line 90.

00850 X=3
00860 ON T/X + 1 GOSUB 640,740,840 NONE 90

===Syntax===
[[Image:Ongosub.png]]

===Defaults===
:1.) Transfer control to the next statement if there is no corresponding line reference.
:2.) Interrupt the program if an error occurs while ON is not active.

===Parameters===
ON GOSUB has two required parameters. "Num-expr" is the numeric expression -a constant, variable, relational expression, or function -that the system is to evaluate. "Line-ref" is the name or number of the line to which control transfers when the value of the numeric expression is matched to the position order of the line-ref.

The optional "NONE line-ref" parameter allows you to specify the line that control should go to when the value of the numeric expression does not fall into the indicated range. This branch is treated as a GOSUB branch rather than an error-processing branch. The branched-to subroutine must end with a [[RETURN]] statement. ON GOSUB also provides error processing with the optional "error-cond line-ref" parameter. See [[Error Conditions]] for more information.

===Technical Considerations===
:1.) Return information for the ON GOSUB statement is kept in the FLOWSTACK. See the [[FLOWSTACK]] specification in the BRConfig.sys chapter for more information.

<noinclude>
[[Category:Statements]]
[[Category:Branching Statements]]
</noinclude>