For Each...Next

From Xojo Documentation

Language Keyword

Loops through the elements of a one-dimensional array or a class that implements the Iterable interface.

Usage

For Each element [As datatype] In array

[statements]

[ Continue [For] ]

[ Exit [For] ]

Next [element]

Part Type Description
element Same type as array A variable of the same data type as array that refers to an element of array. The loop processes each value in array.
datatype Any valid datatype Optional: The data type of the array element.

It can be any one-dimensional array. If you declare the data type with the optional AS clause, you do not have to do so with a Dim statement before the loop. The data type must match array's data type.

array Any valid datatype A one-dimensional array whose data type must match datatype.
Statements Statements to be executed repeatedly inside the loop.
Continue If a Continue statement is present, execution skips directly to the loop's Next statement, thereby causing another loop iteration unless the end is reached.
Exit If an Exit statement is present, execution skips over the remaining statements in the loop and resumes with the statement following the Next statement. See the Exit statement for additional options that are relevant for nested loops.

Notes

A For...Each loop does not guarantee that it will loop through the values in the array in index order. Do not make any assumptions of the traversal order as it is subject to change in the future.

As with other block statements, variables declared within the For...Each loop go out of scope when the loop finishes or exits.

Sample Code

Iterate through an array:

Dim days() As Text = Array("One", "Two", "Three", "Four", "Five")
Dim output As Text
For Each d As Text In days
output = output + d
Next

Calculate the sum of values in an array:

Dim values() As Double = Array(1.5, 5.5, 8.0, 45.0, 22.5)
Dim sum As Double
For Each d As Double In values
sum = sum + d
Next
// sum = 82.5

See Also

For...Next, Dim statements; Array keyword