The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Venus::Code - Code Class

ABSTRACT

Code Class for Perl 5

SYNOPSIS

package main;

use Venus::Code;

my $code = Venus::Code->new(sub {
  my (@args) = @_;

  return [@args];
});

# $code->call(1..4);

DESCRIPTION

This package provides methods for manipulating subroutines.

INHERITS

This package inherits behaviors from:

Venus::Kind::Value

METHODS

This package provides the following methods:

call

call(any @data) (any)

The call method executes and returns the result of the code.

Since 0.01

call example 1
package main;

use Venus::Code;

my $code = Venus::Code->new(sub { ($_[0] // 0) + 1 });

my $call = $code->call;

# 1
call example 2
package main;

use Venus::Code;

my $code = Venus::Code->new(sub { ($_[0] // 0) + 1 });

my $call = $code->call(1);

# 2
call example 3
package main;

use Venus::Code;

my $code = Venus::Code->new(sub { ($_[0] // 0) + 1 });

my $call = $code->call(2);

# 3

cast

cast(string $kind) (object | undef)

The cast method converts "value" objects between different "value" object types, based on the name of the type provided. This method will return undef if the invocant is not a Venus::Kind::Value.

Since 0.08

cast example 1
package main;

use Venus::Code;

my $code = Venus::Code->new(sub{[@_]});

my $cast = $code->cast('array');

# bless({ value => [sub { ... }] }, "Venus::Array")
cast example 2
package main;

use Venus::Code;

my $code = Venus::Code->new;

my $cast = $code->cast('boolean');

# bless({ value => 1 }, "Venus::Boolean")
cast example 3
package main;

use Venus::Code;

my $code = Venus::Code->new(sub{[@_]});

my $cast = $code->cast('code');

# bless({ value => sub { ... } }, "Venus::Code")
cast example 4
package main;

use Venus::Code;

my $code = Venus::Code->new;

my $cast = $code->cast('float');

# bless({ value => "1.0" }, "Venus::Float")
cast example 5
package main;

use Venus::Code;

my $code = Venus::Code->new(sub{[@_]});

my $cast = $code->cast('hash');

# bless({ value => { "0" => sub { ... } } }, "Venus::Hash")
cast example 6
package main;

use Venus::Code;

my $code = Venus::Code->new;

my $cast = $code->cast('number');

# bless({ value => 112 }, "Venus::Number")
cast example 7
package main;

use Venus::Code;

my $code = Venus::Code->new;

my $cast = $code->cast('regexp');

# bless({ value => qr/.../, }, "Venus::Regexp")
cast example 8
package main;

use Venus::Code;

my $code = Venus::Code->new;

my $cast = $code->cast('scalar');

# bless({ value => \sub {...} }, "Venus::Scalar")
cast example 9
package main;

use Venus::Code;

my $code = Venus::Code->new;

my $cast = $code->cast('string');

# bless({ value => "sub {...}" }, "Venus::String")
cast example 10
package main;

use Venus::Code;

my $code = Venus::Code->new;

my $cast = $code->cast('undef');

# bless({ value => undef }, "Venus::Undef")

compose

compose(coderef $code, any @data) (coderef)

The compose method creates a code reference which executes the first argument (another code reference) using the result from executing the code as it's argument, and returns a code reference which executes the created code reference passing it the remaining arguments when executed.

Since 0.01

compose example 1
package main;

use Venus::Code;

my $code = Venus::Code->new(sub { [@_] });

my $compose = $code->compose($code, 1, 2, 3);

# sub { ... }

# $compose->(4, 5, 6); # [[1,2,3,4,5,6]]

conjoin

conjoin(coderef $code) (coderef)

The conjoin method creates a code reference which execute the code and the argument in a logical AND operation having the code as the lvalue and the argument as the rvalue.

Since 0.01

conjoin example 1
package main;

use Venus::Code;

my $code = Venus::Code->new(sub { $_[0] % 2 });

my $conjoin = $code->conjoin(sub { 1 });

# sub { ... }

# $conjoin->(0); # 0
# $conjoin->(1); # 1
# $conjoin->(2); # 0
# $conjoin->(3); # 1
# $conjoin->(4); # 0

curry

curry(any @data) (coderef)

The curry method returns a code reference which executes the code passing it the arguments and any additional parameters when executed.

Since 0.01

curry example 1
package main;

use Venus::Code;

my $code = Venus::Code->new(sub { [@_] });

my $curry = $code->curry(1, 2, 3);

# sub { ... }

# $curry->(4,5,6); # [1,2,3,4,5,6]

default

default() (coderef)

The default method returns the default value, i.e. sub{}.

Since 0.01

default example 1
# given: synopsis;

my $default = $code->default;

# sub {}

disjoin

disjoin(coderef $code) (coderef)

The disjoin method creates a code reference which execute the code and the argument in a logical OR operation having the code as the lvalue and the argument as the rvalue.

Since 0.01

disjoin example 1
package main;

use Venus::Code;

my $code = Venus::Code->new(sub { $_[0] % 2 });

my $disjoin = $code->disjoin(sub { -1 });

# sub { ... }

# disjoin->(0); # -1
# disjoin->(1); #  1
# disjoin->(2); # -1
# disjoin->(3); #  1
# disjoin->(4); # -1

eq

eq(any $arg) (boolean)

The eq method performs an "equals" operation using the argument provided.

Since 0.08

eq example 1
package main;

use Venus::Array;
use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Array->new;

my $result = $lvalue->eq($rvalue);

# 0
eq example 2
package main;

use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Code->new;

my $result = $lvalue->eq($rvalue);

# 1
eq example 3
package main;

use Venus::Code;
use Venus::Float;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Float->new;

my $result = $lvalue->eq($rvalue);

# 0
eq example 4
package main;

use Venus::Code;
use Venus::Hash;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Hash->new;

my $result = $lvalue->eq($rvalue);

# 0
eq example 5
package main;

use Venus::Code;
use Venus::Number;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Number->new;

my $result = $lvalue->eq($rvalue);

# 0
eq example 6
package main;

use Venus::Code;
use Venus::Regexp;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Regexp->new;

my $result = $lvalue->eq($rvalue);

# 0
eq example 7
package main;

use Venus::Code;
use Venus::Scalar;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Scalar->new;

my $result = $lvalue->eq($rvalue);

# 0
eq example 8
package main;

use Venus::Code;
use Venus::String;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::String->new;

my $result = $lvalue->eq($rvalue);

# 0
eq example 9
package main;

use Venus::Code;
use Venus::Undef;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Undef->new;

my $result = $lvalue->eq($rvalue);

# 0

ge

ge(any $arg) (boolean)

The ge method performs a "greater-than-or-equal-to" operation using the argument provided.

Since 0.08

ge example 1
package main;

use Venus::Array;
use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Array->new;

my $result = $lvalue->ge($rvalue);

# 1
ge example 2
package main;

use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Code->new;

my $result = $lvalue->ge($rvalue);

# 1
ge example 3
package main;

use Venus::Code;
use Venus::Float;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Float->new;

my $result = $lvalue->ge($rvalue);

# 1
ge example 4
package main;

use Venus::Code;
use Venus::Hash;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Hash->new;

my $result = $lvalue->ge($rvalue);

# 1
ge example 5
package main;

use Venus::Code;
use Venus::Number;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Number->new;

my $result = $lvalue->ge($rvalue);

# 1
ge example 6
package main;

use Venus::Code;
use Venus::Regexp;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Regexp->new;

my $result = $lvalue->ge($rvalue);

# 1
ge example 7
package main;

use Venus::Code;
use Venus::Scalar;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Scalar->new;

my $result = $lvalue->ge($rvalue);

# 1
ge example 8
package main;

use Venus::Code;
use Venus::String;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::String->new;

my $result = $lvalue->ge($rvalue);

# 1
ge example 9
package main;

use Venus::Code;
use Venus::Undef;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Undef->new;

my $result = $lvalue->ge($rvalue);

# 1

gele

gele(any $arg1, any $arg2) (boolean)

The gele method performs a "greater-than-or-equal-to" operation on the 1st argument, and "lesser-than-or-equal-to" operation on the 2nd argument.

Since 0.08

gele example 1
package main;

use Venus::Array;
use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Array->new;

my $result = $lvalue->gele($rvalue);

# 0
gele example 2
package main;

use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Code->new;

my $result = $lvalue->gele($rvalue);

# 0
gele example 3
package main;

use Venus::Code;
use Venus::Float;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Float->new;

my $result = $lvalue->gele($rvalue);

# 0
gele example 4
package main;

use Venus::Code;
use Venus::Hash;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Hash->new;

my $result = $lvalue->gele($rvalue);

# 0
gele example 5
package main;

use Venus::Code;
use Venus::Number;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Number->new;

my $result = $lvalue->gele($rvalue);

# 0
gele example 6
package main;

use Venus::Code;
use Venus::Regexp;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Regexp->new;

my $result = $lvalue->gele($rvalue);

# 0
gele example 7
package main;

use Venus::Code;
use Venus::Scalar;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Scalar->new;

my $result = $lvalue->gele($rvalue);

# 0
gele example 8
package main;

use Venus::Code;
use Venus::String;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::String->new;

my $result = $lvalue->gele($rvalue);

# 0
gele example 9
package main;

use Venus::Code;
use Venus::Undef;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Undef->new;

my $result = $lvalue->gele($rvalue);

# 0

gt

gt(any $arg) (boolean)

The gt method performs a "greater-than" operation using the argument provided.

Since 0.08

gt example 1
package main;

use Venus::Array;
use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Array->new;

my $result = $lvalue->gt($rvalue);

# 1
gt example 2
package main;

use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Code->new;

my $result = $lvalue->gt($rvalue);

# 0
gt example 3
package main;

use Venus::Code;
use Venus::Float;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Float->new;

my $result = $lvalue->gt($rvalue);

# 1
gt example 4
package main;

use Venus::Code;
use Venus::Hash;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Hash->new;

my $result = $lvalue->gt($rvalue);

# 1
gt example 5
package main;

use Venus::Code;
use Venus::Number;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Number->new;

my $result = $lvalue->gt($rvalue);

# 1
gt example 6
package main;

use Venus::Code;
use Venus::Regexp;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Regexp->new;

my $result = $lvalue->gt($rvalue);

# 1
gt example 7
package main;

use Venus::Code;
use Venus::Scalar;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Scalar->new;

my $result = $lvalue->gt($rvalue);

# 1
gt example 8
package main;

use Venus::Code;
use Venus::String;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::String->new;

my $result = $lvalue->gt($rvalue);

# 1
gt example 9
package main;

use Venus::Code;
use Venus::Undef;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Undef->new;

my $result = $lvalue->gt($rvalue);

# 1

gtlt

gtlt(any $arg1, any $arg2) (boolean)

The gtlt method performs a "greater-than" operation on the 1st argument, and "lesser-than" operation on the 2nd argument.

Since 0.08

gtlt example 1
package main;

use Venus::Array;
use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Array->new;

my $result = $lvalue->gtlt($rvalue);

# 0
gtlt example 2
package main;

use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Code->new;

my $result = $lvalue->gtlt($rvalue);

# 0
gtlt example 3
package main;

use Venus::Code;
use Venus::Float;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Float->new;

my $result = $lvalue->gtlt($rvalue);

# 0
gtlt example 4
package main;

use Venus::Code;
use Venus::Hash;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Hash->new;

my $result = $lvalue->gtlt($rvalue);

# 0
gtlt example 5
package main;

use Venus::Code;
use Venus::Number;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Number->new;

my $result = $lvalue->gtlt($rvalue);

# 0
gtlt example 6
package main;

use Venus::Code;
use Venus::Regexp;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Regexp->new;

my $result = $lvalue->gtlt($rvalue);

# 0
gtlt example 7
package main;

use Venus::Code;
use Venus::Scalar;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Scalar->new;

my $result = $lvalue->gtlt($rvalue);

# 0
gtlt example 8
package main;

use Venus::Code;
use Venus::String;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::String->new;

my $result = $lvalue->gtlt($rvalue);

# 0
gtlt example 9
package main;

use Venus::Code;
use Venus::Undef;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Undef->new;

my $result = $lvalue->gtlt($rvalue);

# 0

le

le(any $arg) (boolean)

The le method performs a "lesser-than-or-equal-to" operation using the argument provided.

Since 0.08

le example 1
package main;

use Venus::Array;
use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Array->new;

my $result = $lvalue->le($rvalue);

# 0
le example 2
package main;

use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Code->new;

my $result = $lvalue->le($rvalue);

# 1
le example 3
package main;

use Venus::Code;
use Venus::Float;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Float->new;

my $result = $lvalue->le($rvalue);

# 0
le example 4
package main;

use Venus::Code;
use Venus::Hash;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Hash->new;

my $result = $lvalue->le($rvalue);

# 0
le example 5
package main;

use Venus::Code;
use Venus::Number;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Number->new;

my $result = $lvalue->le($rvalue);

# 0
le example 6
package main;

use Venus::Code;
use Venus::Regexp;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Regexp->new;

my $result = $lvalue->le($rvalue);

# 0
le example 7
package main;

use Venus::Code;
use Venus::Scalar;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Scalar->new;

my $result = $lvalue->le($rvalue);

# 0
le example 8
package main;

use Venus::Code;
use Venus::String;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::String->new;

my $result = $lvalue->le($rvalue);

# 0
le example 9
package main;

use Venus::Code;
use Venus::Undef;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Undef->new;

my $result = $lvalue->le($rvalue);

# 0

lt

lt(any $arg) (boolean)

The lt method performs a "lesser-than" operation using the argument provided.

Since 0.08

lt example 1
package main;

use Venus::Array;
use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Array->new;

my $result = $lvalue->lt($rvalue);

# 0
lt example 2
package main;

use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Code->new;

my $result = $lvalue->lt($rvalue);

# 0
lt example 3
package main;

use Venus::Code;
use Venus::Float;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Float->new;

my $result = $lvalue->lt($rvalue);

# 0
lt example 4
package main;

use Venus::Code;
use Venus::Hash;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Hash->new;

my $result = $lvalue->lt($rvalue);

# 0
lt example 5
package main;

use Venus::Code;
use Venus::Number;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Number->new;

my $result = $lvalue->lt($rvalue);

# 0
lt example 6
package main;

use Venus::Code;
use Venus::Regexp;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Regexp->new;

my $result = $lvalue->lt($rvalue);

# 0
lt example 7
package main;

use Venus::Code;
use Venus::Scalar;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Scalar->new;

my $result = $lvalue->lt($rvalue);

# 0
lt example 8
package main;

use Venus::Code;
use Venus::String;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::String->new;

my $result = $lvalue->lt($rvalue);

# 0
lt example 9
package main;

use Venus::Code;
use Venus::Undef;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Undef->new;

my $result = $lvalue->lt($rvalue);

# 0

ne

ne(any $arg) (boolean)

The ne method performs a "not-equal-to" operation using the argument provided.

Since 0.08

ne example 1
package main;

use Venus::Array;
use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Array->new;

my $result = $lvalue->ne($rvalue);

# 1
ne example 2
package main;

use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Code->new;

my $result = $lvalue->ne($rvalue);

# 0
ne example 3
package main;

use Venus::Code;
use Venus::Float;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Float->new;

my $result = $lvalue->ne($rvalue);

# 1
ne example 4
package main;

use Venus::Code;
use Venus::Hash;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Hash->new;

my $result = $lvalue->ne($rvalue);

# 1
ne example 5
package main;

use Venus::Code;
use Venus::Number;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Number->new;

my $result = $lvalue->ne($rvalue);

# 1
ne example 6
package main;

use Venus::Code;
use Venus::Regexp;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Regexp->new;

my $result = $lvalue->ne($rvalue);

# 1
ne example 7
package main;

use Venus::Code;
use Venus::Scalar;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Scalar->new;

my $result = $lvalue->ne($rvalue);

# 1
ne example 8
package main;

use Venus::Code;
use Venus::String;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::String->new;

my $result = $lvalue->ne($rvalue);

# 1
ne example 9
package main;

use Venus::Code;
use Venus::Undef;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Undef->new;

my $result = $lvalue->ne($rvalue);

# 1

next

next(any @data) (any)

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.

Since 0.01

next example 1
package main;

use Venus::Code;

my $code = Venus::Code->new(sub { $_[0] * 2 });

my $next = $code->next(72);

# 144

rcurry

rcurry(any @data) (coderef)

The rcurry method returns a code reference which executes the code passing it the any additional parameters and any arguments when executed.

Since 0.01

rcurry example 1
package main;

use Venus::Code;

my $code = Venus::Code->new(sub { [@_] });

my $rcurry = $code->rcurry(1,2,3);

# sub { ... }

# $rcurry->(4,5,6); # [4,5,6,1,2,3]

tv

tv(any $arg) (boolean)

The tv method performs a "type-and-value-equal-to" operation using argument provided.

Since 0.08

tv example 1
package main;

use Venus::Array;
use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Array->new;

my $result = $lvalue->tv($rvalue);

# 0
tv example 2
package main;

use Venus::Code;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Code->new;

my $result = $lvalue->tv($rvalue);

# 1
tv example 3
package main;

use Venus::Code;
use Venus::Float;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Float->new;

my $result = $lvalue->tv($rvalue);

# 0
tv example 4
package main;

use Venus::Code;
use Venus::Hash;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Hash->new;

my $result = $lvalue->tv($rvalue);

# 0
tv example 5
package main;

use Venus::Code;
use Venus::Number;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Number->new;

my $result = $lvalue->tv($rvalue);

# 0
tv example 6
package main;

use Venus::Code;
use Venus::Regexp;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Regexp->new;

my $result = $lvalue->tv($rvalue);

# 0
tv example 7
package main;

use Venus::Code;
use Venus::Scalar;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Scalar->new;

my $result = $lvalue->tv($rvalue);

# 0
tv example 8
package main;

use Venus::Code;
use Venus::String;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::String->new;

my $result = $lvalue->tv($rvalue);

# 0
tv example 9
package main;

use Venus::Code;
use Venus::Undef;

my $lvalue = Venus::Code->new;
my $rvalue = Venus::Undef->new;

my $result = $lvalue->tv($rvalue);

# 0

OPERATORS

This package overloads the following operators:

operation: (&{})

This package overloads the &{} operator.

example 1

# given: synopsis;

my $result = &$code(1..4);

# [1..4]

AUTHORS

Awncorp, awncorp@cpan.org

LICENSE

Copyright (C) 2022, Awncorp, awncorp@cpan.org.

This program is free software, you can redistribute it and/or modify it under the terms of the Apache license version 2.0.