Ant-contrib Tasks: Foreach

# Foreach

The foreach task iterates over a list, a list of paths, or both. If both, list and paths, are specified, the list will be evaluated first. Nested paths are evaluated in the order they appear in the task.

## Parameters

Attribute | Description | Required
--- | --- | ---
list | The list of values to process, with the delimiter character, indicated by the "delimiter" attribute, separating each value. | Yes, unless a nested Fileset has been specified.
target | Name of the target to call for each token or matched file. | Yes
param | Name of the parameter to pass the tokens or files in as to the target. | Yes
delimiter | The delimiter string that separates the values in the "list" attribute. | No, defaults to ",".
inheritall | If `true`, pass all properties to the called target. Defaults to `false`. | No
inheritrefs | If `true`, pass all references to the the called target. Defaults to `false`. | No
parallel | If `true`, all instances of the called target will execute in parallel. Defaults to `false`, which forces sequential execution of the targets. It is up to the caller to ensure that parallel execution is safe. This is accomplished through the means of the "parallel" task contained in the ANT core. | No
maxThreads | The maximum number of allowable threads when executing in parallel. If you are using ANT 1.6 or above, as soon as one thread finishes executing, another will start. However, any ANT version before that will wait until all of the currently running threads are finished before starting the next group of threads. | No. Defaults to 5.
trim | If `true`, any leading or trailing whitespace will be removed from the list item before it is passed to the requested target | No. Defaults to false.

## Parameters specified as nested elements

### path

Paths are used to select sets of files or directories to iterate over.

Using a path allows you to determine the order by which files are considered by using filelists or explicit `pathelements`. You also can specify whether you want to iterate over files or directories by chosing either filesets or dirsets.

### fileset

FileSets are used to select sets of files to iterate over. This element is deprecated, use nested path elements instead.

### param

Specifies the properties to set before running the specified target. See property for usage guidelines.

### reference

Used to chose references that shall be copied into the new project, optionally changing their id.

Attribute | Description | Required
--- | --- | ---
refid | The id of the reference in the calling project. | Yes
torefid | The id of the reference in the called project. | No, defaults to the value of refid.

Copyright © 2002-2003 Ant-Contrib Project. All rights Reserved.