Programmer Guide/Command Reference/FOR - Revision history

Jw at 07:39, 1 June 2015

2015-06-01T07:39:32Z

← Older revision		Revision as of 09:39, 1 June 2015
Line 25:		Line 25:
	END		END

	Neither of <var>target</var>, <var>init</var>, <var>condition</var> and <var>step</var> should ever contain one of the strings "<code>FOR</code>", "<code>TO</code>" or "<code>STEP</code>". If it does, the ~~amazing~~ {{STx}} will most likely mistake the line for an ill-formed <code>FOR</code> statement.		Neither of <var>target</var>, <var>init</var>, <var>condition</var> and <var>step</var> should ever contain one of the strings "<code>FOR</code>", "<code>TO</code>" or "<code>STEP</code>". If it does, the {{STx}} will most likely mistake the line for an ill-formed <code>FOR</code> statement.

Christian at 14:28, 25 April 2014

2014-04-25T14:28:26Z

← Older revision		Revision as of 16:28, 25 April 2014
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	The <code>FOR</code> executes the commands in the block enclosed by the <code>FOR</code> statement and the corresponding <code>END</code> as long as the (slightly misleadingly named) <code>TO</code> condition holds true.		The <code>FOR</code> loop executes the commands in the block enclosed by the <code>FOR</code> statement and the corresponding <code>END</code> as long as the (slightly misleadingly named) <code>TO</code> condition holds true.
	FOR [ <var>target</var> := <var>init</var> ] TO [[Programmer_Guide/Concepts/Conditional_Expressions\|<var>condition</var>]] STEP <var>step</var>		FOR [ <var>target</var> := <var>init</var> ] TO [[Programmer_Guide/Concepts/Conditional_Expressions\|<var>condition</var>]] STEP <var>step</var>
	// commands		// commands
	// ~~...~~		// …
	END		END
	;<var>target</var>		;<var>target</var>
	:The incremental counter variable to initialize with the value <var>init</var> (e.g. #i).		:The incremental counter variable to initialize with the value <var>init</var> (e.g. <var>#i</var>).

	;<var>init</var>		;<var>init</var>
Line 17:		Line 17:
	:The (slightly misleadingly named) <code>step</code> clause is an {{STX}} statement for incrementing the counter variable <var>target</var> at the end of each loop, e.g. the statement <code>#i := int $#i+1</code>.		:The (slightly misleadingly named) <code>step</code> clause is an {{STX}} statement for incrementing the counter variable <var>target</var> at the end of each loop, e.g. the statement <code>#i := int $#i+1</code>.
	FOR #i := 0 TO $#i < 10 STEP #i := int $#i+1		FOR #i := 0 TO $#i < 10 STEP #i := int $#i+1
	BUTIL MSGBOX MSG; #i = $#i		BUTIL MSGBOX MSG; Variable #i currently is $#i
	END		END

	// an example without initialisation		// an example without initialisation
	FOR TO $#x > $#y STEP #i := int $#i + 1		FOR TO $#x > $#y STEP #i := int $#i + 1
	// do something here ~~...~~		// do something here …
	END		END

			Neither of <var>target</var>, <var>init</var>, <var>condition</var> and <var>step</var> should ever contain one of the strings "<code>FOR</code>", "<code>TO</code>" or "<code>STEP</code>". If it does, the amazing {{STx}} will most likely mistake the line for an ill-formed <code>FOR</code> statement.

Christian: Text replace - "Command_Reference_Intro" to "Concepts"

2011-04-13T13:45:45Z

Text replace - "Command_Reference_Intro" to "Concepts"

← Older revision		Revision as of 15:45, 13 April 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	The <code>FOR</code> executes the commands in the block enclosed by the <code>FOR</code> statement and the corresponding <code>END</code> as long as the (slightly misleadingly named) <code>TO</code> condition holds true.		The <code>FOR</code> executes the commands in the block enclosed by the <code>FOR</code> statement and the corresponding <code>END</code> as long as the (slightly misleadingly named) <code>TO</code> condition holds true.
	FOR [ <var>target</var> := <var>init</var> ] TO [[Programmer_Guide/~~Command_Reference_Intro~~/Conditional_Expressions\|<var>condition</var>]] STEP <var>step</var>		FOR [ <var>target</var> := <var>init</var> ] TO [[Programmer_Guide/Concepts/Conditional_Expressions\|<var>condition</var>]] STEP <var>step</var>
	// commands		// commands
	// ...		// ...
Line 12:		Line 12:

	;<var>condition</var>		;<var>condition</var>
	:The condition which should be tested at the start of each loop (e.g. <code>$#i < 10</code>). See [[Programmer_Guide/~~Command_Reference_Intro~~/Conditional_Expressions\|Conditional Expressions]] for further information on conditional expressions.		:The condition which should be tested at the start of each loop (e.g. <code>$#i < 10</code>). See [[Programmer_Guide/Concepts/Conditional_Expressions\|Conditional Expressions]] for further information on conditional expressions.

	;<var>step</var>		;<var>step</var>

Christian: Text replace - "S_TOOLS-STx" to "{{STX}}"

2011-04-05T15:56:16Z

Text replace - "S_TOOLS-STx" to "{{STX}}"

← Older revision		Revision as of 17:56, 5 April 2011
Line 15:		Line 15:

	;<var>step</var>		;<var>step</var>
	:The (slightly misleadingly named) <code>step</code> clause is an ~~S_TOOLS-STx~~ statement for incrementing the counter variable <var>target</var> at the end of each loop, e.g. the statement <code>#i := int $#i+1</code>.		:The (slightly misleadingly named) <code>step</code> clause is an {{STX}} statement for incrementing the counter variable <var>target</var> at the end of each loop, e.g. the statement <code>#i := int $#i+1</code>.
	FOR #i := 0 TO $#i < 10 STEP #i := int $#i+1		FOR #i := 0 TO $#i < 10 STEP #i := int $#i+1
	BUTIL MSGBOX MSG; #i = $#i		BUTIL MSGBOX MSG; #i = $#i

Christian at 20:30, 22 March 2011

2011-03-22T20:30:20Z

← Older revision		Revision as of 22:30, 22 March 2011
Line 15:		Line 15:

	;<var>step</var>		;<var>step</var>
	:The ~~incremental value to add to~~ the counter variable <var>target</var> at the end of each loop~~. The assignment syntax (~~e.g. #i := int $#i+1~~) is allowed~~.		:The (slightly misleadingly named) <code>step</code> clause is an S_TOOLS-STx statement for incrementing the counter variable <var>target</var> at the end of each loop, e.g. the statement <code>#i := int $#i+1</code>.
	FOR #i := 0 TO $#i < 10 STEP #i := int $#i+1		FOR #i := 0 TO $#i < 10 STEP #i := int $#i+1
	BUTIL MSGBOX MSG; #i = $#i		BUTIL MSGBOX MSG; #i = $#i

Christian at 20:28, 22 March 2011

2011-03-22T20:28:20Z

← Older revision		Revision as of 22:28, 22 March 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	The <code>FOR</code> executes the commands in the block enclosed by the <code>FOR</code> statement and the corresponding <code>END</code> as long as the (slightly misleadingly named) <code>TO</code> condition holds true.		The <code>FOR</code> executes the commands in the block enclosed by the <code>FOR</code> statement and the corresponding <code>END</code> as long as the (slightly misleadingly named) <code>TO</code> condition holds true.
	FOR [ <var>target</var> := <var>init</var> ] TO <var>~~cond~~</var> STEP <var>step</var>		FOR [ <var>target</var> := <var>init</var> ] TO [[Programmer_Guide/Command_Reference_Intro/Conditional_Expressions\|<var>condition</var>]] STEP <var>step</var>
	// commands		// commands
	// ...		// ...
Line 11:		Line 11:
	:The value with which to initialize the counter variable <var>target</var> (e.g. 0).		:The value with which to initialize the counter variable <var>target</var> (e.g. 0).

	;<var>~~cond~~</var>		;<var>condition</var>
	:The condition which should be tested at the start of each loop (e.g. $#i < 10). See ~~the~~ [[~~Programmer Guide~~/~~Command Reference Intro~~/~~condition~~\|~~condition~~]] ~~topic~~ for ~~the condition syntax~~.		:The condition which should be tested at the start of each loop (e.g. <code>$#i < 10</code>). See [[Programmer_Guide/Command_Reference_Intro/Conditional_Expressions\|Conditional Expressions]] for further information on conditional expressions.

	;<var>step</var>		;<var>step</var>

Christian: /* FOR */

2011-03-22T20:26:27Z

FOR

← Older revision		Revision as of 22:26, 22 March 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	==FOR==		The <code>FOR</code> executes the commands in the block enclosed by the <code>FOR</code> statement and the corresponding <code>END</code> as long as the (slightly misleadingly named) <code>TO</code> condition holds true.
			FOR [ <var>target</var> := <var>init</var> ] TO <var>cond</var> STEP <var>step</var>
	<code>FOR [ <var>target</var> := <var>init</var> ] TO <var>cond</var> STEP <var>step</var> // commands		// commands
	~~END<~~/~~code>~~		// ...
			END
	~~Excecute the commands in the FOR loop while the condition holds true~~.

	;<var>target</var>		;<var>target</var>

	:The incremental counter variable to initialize with the value <var>init</var> (e.g. #i).		:The incremental counter variable to initialize with the value <var>init</var> (e.g. #i).

	;<var>init</var>		;<var>init</var>

	:The value with which to initialize the counter variable <var>target</var> (e.g. 0).		:The value with which to initialize the counter variable <var>target</var> (e.g. 0).

	;<var>cond</var>		;<var>cond</var>

	:The condition which should be tested at the start of each loop (e.g. $#i < 10). See the [[Programmer Guide/Command Reference Intro/condition\|condition]] topic for the condition syntax.		:The condition which should be tested at the start of each loop (e.g. $#i < 10). See the [[Programmer Guide/Command Reference Intro/condition\|condition]] topic for the condition syntax.

	;<var>step</var>		;<var>step</var>

	:The incremental value to add to the counter variable <var>target</var> at the end of each loop. The assignment syntax (e.g. #i := int $#i+1) is allowed.		:The incremental value to add to the counter variable <var>target</var> at the end of each loop. The assignment syntax (e.g. #i := int $#i+1) is allowed.
			FOR #i := 0 TO $#i < 10 STEP #i := int $#i+1
			BUTIL MSGBOX MSG; #i = $#i
			END

	~~<pre>~~		// an example without initialisation
	~~FOR #i := 0 TO $#i < 10 STEP #i := int $#i+1~~		FOR TO $#x > $#y STEP #i := int $#i + 1
	~~BUTIL MSGBOX MSG; #i = $#i~~		// do something here ...
	~~END~~		END
	// an example without initialisation
	FOR TO $#x > $#y STEP #i := int $#i + 1
	// do something here ...
	END
	~~</pre>~~

Admin: /* FOR */

2011-03-22T16:23:30Z

FOR

← Older revision		Revision as of 18:23, 22 March 2011
Line 17:		Line 17:
	;<var>cond</var>		;<var>cond</var>

	:The condition which should be tested at the start of each loop (e.g. $#i < 10). See the [[Programmer Guide/Command Reference/condition\|condition]] topic for the condition syntax.		:The condition which should be tested at the start of each loop (e.g. $#i < 10). See the [[Programmer Guide/Command Reference Intro/condition\|condition]] topic for the condition syntax.

	;<var>step</var>		;<var>step</var>

Admin: 1 revision: Initial import

2010-11-18T16:31:35Z

1 revision: Initial import

← Older revision	Revision as of 18:31, 18 November 2010
(No difference)

193.171.195.8: initial import

2010-05-17T13:05:27Z

initial import

New page

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
==FOR==

<code>FOR [ <var>target</var> := <var>init</var> ] TO <var>cond</var> STEP <var>step</var> // commands
END</code>

Excecute the commands in the FOR loop while the condition holds true.

;<var>target</var>

:The incremental counter variable to initialize with the value <var>init</var> (e.g. #i).

;<var>init</var>

:The value with which to initialize the counter variable <var>target</var> (e.g. 0).

;<var>cond</var>

:The condition which should be tested at the start of each loop (e.g. $#i < 10). See the [[Programmer Guide/Command Reference/condition|condition]] topic for the condition syntax.

;<var>step</var>

:The incremental value to add to the counter variable <var>target</var> at the end of each loop. The assignment syntax (e.g. #i := int $#i+1) is allowed.

<pre>
FOR #i := 0 TO $#i < 10 STEP #i := int $#i+1
BUTIL MSGBOX MSG; #i = $#i
END
// an example without initialisation
FOR TO $#x > $#y STEP #i := int $#i + 1
// do something here ...
END
</pre>