... Iterator over the lines in a file . ... Returns false when the iterator is exhausted. my $it = new TWiki::ListIterator(\@list); while ($it->hasNext()) { .. ... The iterator object can be customised to pre- and post-process entries from the list before returning them. ... For example, my $it = new TWiki::LineIterator("/etc/passwd"); $it->{filter} = sub { $_[0] =~ /^.*?:/; return $1; }; $it->{process} = sub { return "User $_[0]"; }; while ($it->hasNext()) { my $x = $it->next(); print "$x\n"; } . ...