Man pages sections > man3 > Data::Stream::Bulk::Util

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

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> 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.
2012-02-14 perl v5.14.2