Bubblegum::Object::Code - Common Methods for Operating on Code References
version 0.26
use Bubblegum; my $code = sub { shift + 1 }; say $code->call(2); # 3
Code methods work on code references. It is not necessary to use this module as it is loaded automatically by the Bubblegum class.
my $code = sub { (shift // 0) + 1 }; $code->call; # 1 $code->call(0); # 1 $code->call(1); # 2 $code->call(2); # 3
The call method executes and returns the result of the subject.
my $code = sub { [@_] }; $code = $code->curry(1,2,3); $code->(4,5,6); # [1,2,3,4,5,6]
The curry method returns a code reference which executes the subject passing it the arguments and any additional parameters when executed.
my $code = sub { [@_] }; $code = $code->rcurry(1,2,3); $code->(4,5,6); # [4,5,6,1,2,3]
The rcurry method returns a code reference which executes the subject passing it the any additional parameters and any arguments when executed.
my $code = sub { [@_] }; $code = $code->compose($code, 1,2,3); $code->(4,5,6); # [[1,2,3,4,5,6]] # this can be confusing, here's what's really happening: my $listing = sub {[@_]}; # produces an arrayref of args $listing->($listing->(@args)); # produces a listing within a listing [[@args]] # the result
The compose method creates a code reference which executes the first argument (another code reference) using the result from executing the subject as it's argument, and returns a code reference which executes the created code reference passing it the remaining arguments when executed.
my $code = sub { $_[0] % 2 }; $code = $code->disjoin(sub { -1 }); $code->(0); # -1 $code->(1); # 1 $code->(2); # -1 $code->(3); # 1 $code->(4); # -1
The disjoin method creates a code reference which execute the subject and the argument in a logical OR operation having the subject as the lvalue and the argument as the rvalue.
my $code = sub { $_[0] % 2 }; $code = $code->conjoin(sub { 1 }); $code->(0); # 0 $code->(1); # 1 $code->(2); # 0 $code->(3); # 1 $code->(4); # 0
The conjoin method creates a code reference which execute the subject and the argument in a logical AND operation having the subject as the lvalue and the argument as the rvalue.
$code->next;
The next method is an alias to the call method. The naming is especially useful (i.e. helps with readability) when used with closure-based iterators.
Bubblegum::Object::Array, Bubblegum::Object::Code, Bubblegum::Object::Hash, Bubblegum::Object::Instance, Bubblegum::Object::Integer, Bubblegum::Object::Number, Bubblegum::Object::Scalar, Bubblegum::Object::String, Bubblegum::Object::Undef, Bubblegum::Object::Universal,
Al Newkirk <anewkirk@ana.io>
This software is copyright (c) 2013 by Al Newkirk.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Bubblegum, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Bubblegum
CPAN shell
perl -MCPAN -e shell install Bubblegum
For more information on module installation, please visit the detailed CPAN module installation guide.