# Data::Stream::Bulk::Filter - phpMan

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