NAME

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

VERSION

version 0.11

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.

AUTHOR

Yuval Kogman <nothingmuch@woobling.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Yuval Kogman.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.