foreach
 
 
 

Evaluates expressions for all members of a list

(foreach name list [expr...])

The foreach function steps through a list, assigning each element in the list to a variable, and evaluates each expression for every element in the list. Any number of expressions can be specified.

Arguments

name

Variable that each element in the list will be assigned to.

list

List to be stepped through and evaluated.

expr

Expression to be evaluated for each element in list.

Return Values

The result of the last expr evaluated. If no expr is specified, foreach returns nil.

Examples

Print each element in a list:

Command: (foreach n '(a b c) (print n))

A

B

C C

foreach prints each element in the list and returns C, the last element. This command is equivalent to the following sequence of commands, except that foreach returns the result of only the last expression evaluated:

(print a) 
(print b) 
(print c)