NAME
Mojo::Collection - Collection
SYNOPSIS
# Manipulate collections
use Mojo::Collection;
my $collection = Mojo::Collection->new(1, 2, 3);
my $doubled = $collection->map(sub { $_ * 2 });
$doubled->each(sub {
my ($num, $count) = @_;
print "$count: $num\n";
});
# Use the alternative constructor
use Mojo::Collection 'c';
c(1, 2, 3)->join("\n")->say;DESCRIPTION
Mojo::Collection is a container for collections. Note that this module is EXPERIMENTAL and might change without warning!
METHODS
Mojo::Collection inherits all methods from Mojo::Base and implements the following new ones.
new
my $collection = Mojo::Collection->new(1, 2, 3);Construct a new Mojo::Collection object.
each
my @elements = $collection->each;
$collection = $collection->each(sub { print shift->text });
$collection = $collection->each(sub {
my ($e, $count) = @_;
print "$count: $e\n";
});Iterate over whole collection.
join
my $stream = $collection->join("\n");Turn collection into Mojo::ByteStream.
$collection->join("\n")->say;map
my $new = $collection->map(sub {...});Evaluate closure for each element in collection and create a new collection from the results.
my $doubled = $collection->map(sub { $_ * 2 });size
my $size = $collection->size;Number of elements in collection.
until
$collection = $collection->until(sub { $_ =~ /x/ && print $_ });
$collection = $collection->until(sub {
my ($e, $count) = @_;
$e =~ /x/ && print "$count: $e\n";
});Iterate over collection until closure returns true.
while
$collection = $collection->while(sub { print($_) && $_ =~ /x/});
$collection = $collection->while(sub {
my ($e, $count) = @_;
print("$count: $e\n") && $e =~ /x/;
});Iterate over collection while closure returns true.