DOC1 Programmer's Guide

Programming PCE
for…next
Function. Indicates script statements that are to be processed repeatedly a fixed number of times.
Syntax. for [counter =] start to end ;
...
next;
Parameters counter a variable to hold the loop counter
start
integer; the base number of the loop counter when it is first processed
end
integer; the number of the loop counter when processing is to end.
Effects
Statements between the for and next commands will be executed the number of times
indicated by the difference between start and end. For example, 1 to 5 will execute the loop
five times; 3 to 4 will execute the loop twice.
The current sequence number within the start/end range is used to update counter at the start
of each pass.
Comments If coded, the contents of the counter variable may be referenced within the loop. It can be
omitted unless you want to nest for…next loops in which case each must be assigned to a
different variable.
Example for = 1 to 4;
// Get file name for th output file
// convert numeric to string and append to base file name
let = STRING ;
let = + ;
// open th file
open for output as file LINE / PLAIN;
// read fields from next input file record
let = 7;
read items from file 0 into ;
// NOTE: arrays are indexed from 0
let = - 1;
for = 0 to ;
// Output fields read from th record of input file
// as separate records in the th output file
write 1 item into file from ();
next; //
next; //
46