mirror of
https://github.com/QB64Official/qb64.git
synced 2024-08-31 14:40:15 +00:00
41 lines
No EOL
1.5 KiB
Text
41 lines
No EOL
1.5 KiB
Text
[[NEXT]] is used in a [[FOR...NEXT|FOR]] counter loop to progress through the loop count.
|
|
|
|
|
|
{{PageSyntax}}
|
|
: [[FOR]] {{Parameter|counterVariable}} = {{Parameter|startValue}} [[TO]] {{Parameter|stopValue}} [{{KW|STEP}} {{Parameter|increment}}]
|
|
:: ''{code}''
|
|
:: ⋮
|
|
: [[NEXT]] [{{Parameter|counterVariable}}]
|
|
|
|
|
|
{{PageDescription}}
|
|
* [[NEXT]] is required in a FOR loop or a [[ERROR Codes|"FOR without NEXT" error]] will occur.
|
|
* The FOR variable name is not required after [[NEXT]].
|
|
* [[NEXT]] can be grouped with other NEXTs in nested FOR loops using colons like [[NEXT]]: [[NEXT]]
|
|
* [[NEXT]] can also end more than one nested [[FOR...NEXT|FOR]] loop using comma separated variables like [[NEXT]] i, j
|
|
* [[NEXT]] increases the FOR loop count, so after the loop is over the counterVariable's value will be stopValue + 1 (or stopValue + increment).
|
|
* [[NEXT]] is also used with the [[RESUME]] statement.
|
|
|
|
|
|
{{PageExamples}}
|
|
''Example:'' Finding the FOR variable value AFTER a simple counter loop to 10.
|
|
{{CodeStart}} '' ''
|
|
FOR i = 1 TO 10
|
|
PRINT i;
|
|
NEXT i
|
|
|
|
PRINT "AFTER the LOOP, NEXT makes the value of i ="; i '' ''
|
|
{{CodeEnd}}
|
|
{{OutputStart}}
|
|
1 2 3 4 5 6 7 8 9 10 AFTER the LOOP, NEXT makes the value of i = 11
|
|
{{OutputEnd}}
|
|
''Result:'' The last value of i = 11 although FOR only looped 10 times. '''Only use the count values while inside of the loop or compensate for this behavior in your code.'''
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[FOR...NEXT]]
|
|
* [[DO...LOOP]]
|
|
* [[RESUME|RESUME NEXT]]
|
|
|
|
|
|
{{PageNavigation}} |