On this page

$iterator is used with the #foreach loops. It wraps a list to let you specify a condition to terminate the loop and reuse the same list in a different loop. The following example shows how to use $iterator.

#set ($list = [1, 2, 3, 5, 8, 13])
#set ($numbers = $iterator.wrap($list))
#foreach ($item in $numbers)
#if ($item < 8) $numbers.more()#end
#end
$numbers.more()
Output
------
1 2 3 5
8

$iterator.wrap( list )

Wrap a list with the tool.


Name Type Description 
Parameter(s) list java.util.List An array or a
list instance. 
 ReturnIteratorTool Return an
IteratorTool
instance. 

$<IteratorTool instance>.hasMore()

Check if the iteration has more elements.


Name Type Description 
Return boolean Return true if there
are more elements
in the wrapped list. 

$<IteratorTool instance>.more()

Ask for the next element in the list.


Name Type Description 
Return  java.lang.Object An element
instance. 

$<IteratorTool instance>.remove()

Remove the current element from the list.

$<IteratorTool instance>.reset()

Reset the wrapper so that it will start over at the beginning of the list.

$<IteratorTool instance>.stop()

Put a condition to break off a loop.

$<IteratorTool instance>.toString()

Return an object as a string.