Handel::Iterator::Results - Iterator class used for collection looping storage iterators

    my $iterator = $storage->search;

    my $results = Handel::Iterator::Results->new({
        data         => $iterator,
        result_class => 'MyCart'
    });

    while (my $cart = $results->next) {
        print $cart->id;
    };

Handel::Iterator::Results is a used to iterate through result iterators returned by storage search/search_items operations. The only different between this, and Handel::Iterator::DBIC and Handel::Iterator::List is that it inflates results into the interface classes rather than into storage results.

Arguments: \%options

Creates a new iterator object. The following options are available:

    my $iterator = $storage->search;

    my $results = Handel::Iterator::Results->new({
        data         => $iterator,
        result_class => 'MyCart'
    });

    my $cart = $results->first;
    print ref $cart; # MyCart

data

The data to be iterated through. This should be an iterator returns by storage.

result_class

The name of the class that each result should be inflated into.

Returns all results from current iterator.

    foreach my $result ($iterator->all) {
        print $result->method;
    };

Returns the number of results in the current iterator.

    my $count = $iterator->count;

Arguments: $result

Returns a new result class object based on the specified result objects.

This method is used by methods like first and next to to create result class objects. There is probably no good reason to use this method directly.

Returns the first result or undef if there are no results.

    my $first = $iterator->first;

Returns the last result or undef if there are no results.

    my $last = $iterator->last;

Returns the next result or undef if there are no results.

    while (my $result = $iterator->next) {
        print $result->method;
    };

Resets the current result position back to the first result.

    while (my $result = $iterator->next) {
        print $result->method;
    };

    $iterator->reset;

    while (my $result = $iterator->next) {
        print $result->method;
    };

Handel::Iterator::List, Handel::Iterator::DBIC

    Christopher H. Laco
    CPAN ID: CLACO
    claco@chrislaco.com
    http://today.icantfocus.com/blog/