Linux Certif

Toute la documentation sur la certification Linux LPI

Data::Stream::Bulk::DoneFlag.3pm

NAME

Data::Stream::Bulk::DoneFlag - Implement the "is_done" method in terms of a flag

SYNOPSIS

         package Data::Stream::Bulk::Blah;
         use Moose;
 
         with qw(Data::Stream::Bulk::DoneFlag);
 
         sub get_more {
                 if ( my @more = more() ) {
                         return \@more;
                 } else {
                         return;
                 }
         }
 
 

DESCRIPTION

This role implements the "Data::Stream::Bulk" core API in terms of one method ("get_more").

As a convenience it calls "finished" when the stream is exhausted, so that cleanup may be done.

This is used by classes like Data::Stream::Bulk::DBI, Data::Stream::Bulk::Callback.

METHODS

is_done

Returns the state of the iterator.

next

As long as the iterator is not yet done, calls "get_more".

If "get_more" returned a false value instead of an array reference then "done" is set, "finished" is called, and this "next" does nothing on subsequent calls.

finished

A noop by default. Can be overridden if so desired.

REQUIRED_METHODS

get_more

Returns the next block of data as an array ref, or a false value if no items are left.