# Class::DBI::Iterator - phpMan

## 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.