NEXT: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
Line 3: Line 3:


{{PageSyntax}}
{{PageSyntax}}
: [[FOR]] {{Parameter|counterVariable}} = {{Parameter|startValue}} [[TO]] {{Parameter|stopValue}} [{{KW|STEP}} {{Parameter|increment}}]
: [[FOR]] {{Parameter|counterVariable}} = {{Parameter|startValue}} [[TO]] {{Parameter|stopValue}} [[[STEP]] {{Parameter|increment}}]
:: ''{code}''
:: ''{code}''
:: ⋮
:: ⋮

Latest revision as of 00:51, 25 January 2023

NEXT is used in a FOR counter loop to progress through the loop count.


Syntax

FOR counterVariable = startValue TO stopValue [[[STEP]] increment]
{code}
NEXT [counterVariable]


Description

  • NEXT is required in a FOR loop or a "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 loop using comma separated variables like NEXT j, i
  • 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.


Examples

Example: Finding the FOR variable value AFTER a simple counter loop to 10.

FOR i = 1 TO 10
PRINT i;
NEXT i

PRINT "AFTER the LOOP, NEXT makes the value of i ="; i
1 2 3 4 5 6 7 8 9 10 AFTER the LOOP, NEXT makes the value of i = 11

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.


See also



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link