Foreach - Function Summary

Summary:

Evaluates a block for each value(s) in a series.

Usage:

foreach word data body

Arguments:

word - Word or block of words to set each time (will be local) (must be: get-word word block)

data - The series to traverse (must be: series)

body - Block to evaluate each time (must be: block)

Description:

For every value in a series, such as a block or string, this function will evaluate a block using a variable that holds that value.

For example, the series below is a block of city names. For each name in that block, the PRINT function will be evaluated. The CITY variable holds the name of the city each time.

cities: ["Eureka" "Ukiah" "Santa Rosa" "Mendocino"] foreach city cities [print city] Eureka Ukiah Santa Rosa Mendocino

This also works for strings. Each character of the string will be printed below:

chars: "abcdef" foreach char chars [print char] a b c d e f

The second argument can also be a block of words to get multiple values at the same time from the block:

months: ["March" 31 "April" 30 "May" 31 "June" 30] foreach [name days] months [print [name "has" days "days"]] March has 31 days April has 30 days May has 31 days June has 30 days

Related:

for - Repeats a block over a range of values.
forall - Evaluates a block for every value in a series.
forskip - Evaluates a block for periodic values in a series.