NAME

Data::Stream::Bulk::Filter - Streamed filtering (block oriented)

SYNOPSIS

        use Data::Stream::Bulk::Filter;

        Data::Stream::Bulk::Filter->new(
                filter => sub { ... },
                stream => $stream,
        );

DESCRIPTION

This class implements filtering of streams.

ATTRIBUTES

filter

The code reference to apply to each block.

The block is passed to the filter both in $_ and as the first argument.

The return value should be an array reference. If no true value is returned the output stream does not end, but instead an empty block is substituted (the parent stream controls when the stream is depleted).

stream

The stream to be filtered

METHODS

is_done

loaded

Delegated to stream

next

Calls next on stream and applies filter if a block was returned.