# Template::Plugin::Iterator - perldoc - [phpMan]

## NAME
    [Template::Plugin::Iterator](https://www.chedong.com/phpMan.php/perldoc/Template%3A%3APlugin%3A%3AIterator/markdown) - Plugin to create iterators ([Template::Iterator](https://www.chedong.com/phpMan.php/perldoc/Template%3A%3AIterator/markdown))

## SYNOPSIS
        [% USE iterator(list, args) %]

        [% FOREACH item = iterator %]
           [% '<ul>' IF iterator.first %]
           <li>[% item %]
           [% '</ul>' IF iterator.last %]
        [% END %]

## DESCRIPTION
    The iterator plugin provides a way to create a [Template::Iterator](https://www.chedong.com/phpMan.php/perldoc/Template%3A%3AIterator/markdown) object to iterate over a data
    set. An iterator is implicitly automatically by the FOREACH directive. This plugin allows the
    iterator to be explicitly created with a given name.

## AUTHOR
    Andy Wardley <<abw@wardley.org>> <<http://wardley.org/>>

## COPYRIGHT
    Copyright (C) 1996-2007 Andy Wardley. All Rights Reserved.

    This module is free software; you can redistribute it and/or modify it under the same terms as
    Perl itself.

## SEE ALSO
    [Template::Plugin](https://www.chedong.com/phpMan.php/perldoc/Template%3A%3APlugin/markdown), [Template::Iterator](https://www.chedong.com/phpMan.php/perldoc/Template%3A%3AIterator/markdown)