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

       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.

perl v5.40.1                                       2025-08-14                      Data::Stream::Bulk::Util(3pm)

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

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

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

               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();

       version 0.11