Take me over?
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.