---
name: "Data::Stream::Bulk::Filter"
section: "3pm"
platform: "linux"
package: "libdata-stream-bulk-perl"
version: "0.11-1.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Data::Stream::Bulk::Filter"
---

# Data::Stream::Bulk::Filter(3pm)

Streamed filtering (block oriented)

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