debian man page for class::dbi::iterator

Class::DBI::Iterator(3pm)				User Contributed Perl Documentation				 Class::DBI::Iterator(3pm)

NAME
       Class::DBI::Iterator - Iterate over Class::DBI search results

SYNOPSIS
	       my $it = My::Class->search(foo => 'bar');

	       my $results = $it->count;

	       my $first_result = $it->first;
	       while ($it->next) { ... }

	       my @slice = $it->slice(10,19);
	       my $slice = $it->slice(10,19);

	       $it->reset;

	       $it->delete_all;

DESCRIPTION
       Any Class::DBI search (including a has_many method) which returns multiple objects can be made to return an iterator instead simply by
       executing the search in scalar context.

       Then, rather than having to fetch all the results at the same time, you can fetch them one at a time, potentially saving a considerable
       amount of processing time and memory.

CAVEAT
       Note that there is no provision for the data changing (or even being deleted) in the database inbetween performing the search and
       retrieving the next result.

perl v5.12.4							    2005-09-11						 Class::DBI::Iterator(3pm)