data::stream::bulk::filter(3pm) [debian man page]

Data::Stream::Bulk::Filter(3pm) 			User Contributed Perl Documentation			   Data::Stream::Bulk::Filter(3pm)

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.

perl v5.14.2							    2012-02-14					   Data::Stream::Bulk::Filter(3pm)

Data::Stream::Bulk::Util(3pm)				User Contributed Perl Documentation			     Data::Stream::Bulk::Util(3pm)

NAME

       Data::Stream::Bulk::Util - Utility functions for Data::Stream::Bulk

VERSION

       version 0.11

SYNOPSIS

	       use Data::Stream::Bulk::Util qw(array);

	       use namespace::clean;

	       # Wrap a list in L<Data::Stream::Bulk::Array>
	       return bulk(qw(foo bar gorch baz));

	       # return an empty resultset
	       return nil();

DESCRIPTION

       This module exports convenience functions for use with Data::Stream::Bulk.

EXPORTS

       Sub::Exporter is used to create the "import" routine, and all of its aliasing/currying goodness is of course supported.

       nil Creates a new Data::Stream::Bulk::Nil object.

	   Takes no arguments.

       bulk @items
	   Creates a new Data::Stream::Bulk::Array wrapping @items.

       cat @streams
	   Concatenate several streams together.

	   Returns "nil" if no arguments are provided.

       filter { ... } $stream
	   Calls "filter" on $stream with the provided filter.

       unique $stream
	   Filter the stream to remove duplicates.

	   Note that memory use may potentially scale to O(k) where k is the number of distinct items, because this is implemented in terms of a
	   seen hash.

	   In the future this will be optimized to be iterative for sorted streams.

	   References are keyed by their refaddr (see "id" in Hash::Util::FieldHash).

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.

perl v5.14.2							    2012-02-14					     Data::Stream::Bulk::Util(3pm)