NAME

Venus::Array - Array Class

ABSTRACT

Array Class for Perl 5

SYNOPSIS

package main;

use Venus::Array;

my $array = Venus::Array->new([1..9]);

# $array->random;

DESCRIPTION

This package provides methods for manipulating array data.

INHERITS

This package inherits behaviors from:

Venus::Kind::Value

INTEGRATES

This package integrates behaviors from:

Venus::Role::Mappable

METHODS

This package provides the following methods:

all

all(coderef $code) (boolean)

The all method returns true if the callback returns true for all of the elements.

Since 0.01

all example 1

# given: synopsis;

my $all = $array->all(sub {
  $_ > 0;
});

# 1

all example 2

# given: synopsis;

my $all = $array->all(sub {
  my ($key, $value) = @_;

  $value > 0;
});

# 1

any

any(coderef $code) (boolean)

The any method returns true if the callback returns true for any of the elements.

Since 0.01

any example 1

# given: synopsis;

my $any = $array->any(sub {
  $_ > 4;
});

any example 2

# given: synopsis;

my $any = $array->any(sub {
  my ($key, $value) = @_;

  $value > 4;
});

call

call(string $iterable, string $method) (any)

The call method executes the given method (named using the first argument) which performs an iteration (i.e. takes a callback) and calls the method (named using the second argument) on the object (or value) and returns the result of the iterable method.

Since 1.02

call example 1

# given: synopsis

package main;

my $call = $array->call('map', 'incr');

# [2..10]

call example 2

# given: synopsis

package main;

my $call = $array->call('grep', 'gt', 4);

# [4..9]

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::Array;

my $array = Venus::Array->new;

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

# bless({ value => [] }, "Venus::Array")

cast example 2

package main;

use Venus::Array;

my $array = Venus::Array->new;

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

# bless({ value => 1 }, "Venus::Boolean")

cast example 3

package main;

use Venus::Array;

my $array = Venus::Array->new;

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

# bless({ value => sub { ... } }, "Venus::Code")

cast example 4

package main;

use Venus::Array;

my $array = Venus::Array->new;

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

# bless({ value => "1.0" }, "Venus::Float")

cast example 5

package main;

use Venus::Array;

my $array = Venus::Array->new;

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

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

cast example 6

package main;

use Venus::Array;

my $array = Venus::Array->new;

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

# bless({ value => 2 }, "Venus::Number")

cast example 7

package main;

use Venus::Array;

my $array = Venus::Array->new;

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

# bless({ value => qr/(?^u:\[\])/ }, "Venus::Regexp")

cast example 8

package main;

use Venus::Array;

my $array = Venus::Array->new;

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

# bless({ value => \[] }, "Venus::Scalar")

cast example 9

package main;

use Venus::Array;

my $array = Venus::Array->new;

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

# bless({ value => "[]" }, "Venus::String")

cast example 10

package main;

use Venus::Array;

my $array = Venus::Array->new;

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

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

count

count() (number)

The count method returns the number of elements within the array.

Since 0.01

count example 1

# given: synopsis;

my $count = $array->count;

# 9

default

default() (arrayref)

The default method returns the default value, i.e. [].

Since 0.01

default example 1

# given: synopsis;

my $default = $array->default;

# []

delete

delete(number $index) (any)

The delete method returns the value of the element at the index specified after removing it from the array.

Since 0.01

delete example 1

# given: synopsis;

my $delete = $array->delete(2);

# 3

each

each(coderef $code) (arrayref)

The each method executes a callback for each element in the array passing the index and value as arguments. This method can return a list of values in list-context.

Since 0.01

each example 1

# given: synopsis;

my $each = $array->each(sub {
  [$_]
});

# [[1], [2], [3], [4], [5], [6], [7], [8], [9]]

each example 2

# given: synopsis;

my $each = $array->each(sub {
  my ($key, $value) = @_;

  [$key, $value]
});

# [
#   [0, 1],
#   [1, 2],
#   [2, 3],
#   [3, 4],
#   [4, 5],
#   [5, 6],
#   [6, 7],
#   [7, 8],
#   [8, 9],
# ]

empty

empty() (Venus::Array)

The empty method drops all elements from the array.

Since 0.01

empty example 1

# given: synopsis;

my $empty = $array->empty;

# bless({ value => [] }, "Venus::Array")

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;

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

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

# 1

eq example 2

package main;

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

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

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

# 0

eq example 3

package main;

use Venus::Array;
use Venus::Float;

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

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

# 0

eq example 4

package main;

use Venus::Array;
use Venus::Hash;

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

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

# 0

eq example 5

package main;

use Venus::Array;
use Venus::Number;

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

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

# 0

eq example 6

package main;

use Venus::Array;
use Venus::Regexp;

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

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

# 0

eq example 7

package main;

use Venus::Array;
use Venus::Scalar;

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

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

# 0

eq example 8

package main;

use Venus::Array;
use Venus::String;

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

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

# 0

eq example 9

package main;

use Venus::Array;
use Venus::Undef;

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

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

# 0

exists

exists(number $index) (boolean)

The exists method returns true if the element at the index specified exists, otherwise it returns false.

Since 0.01

exists example 1

# given: synopsis;

my $exists = $array->exists(0);

# 1

find

find(string @keys) (any)

The find method traverses the data structure using the keys and indices provided, returning the value found or undef. In list-context, this method returns a tuple, i.e. the value found and boolean representing whether the match was successful.

Since 0.01

find example 1

package main;

use Venus::Array;

my $array = Venus::Array->new([{'foo' => {'bar' => 'baz'}}, 'bar', ['baz']]);

my $find = $array->find(0, 'foo');

# { bar => "baz" }

find example 2

package main;

use Venus::Array;

my $array = Venus::Array->new([{'foo' => {'bar' => 'baz'}}, 'bar', ['baz']]);

my $find = $array->find(0, 'foo', 'bar');

# "baz"

find example 3

package main;

use Venus::Array;

my $array = Venus::Array->new([{'foo' => {'bar' => 'baz'}}, 'bar', ['baz']]);

my $find = $array->find(2, 0);

# "baz"

first

first() (any)

The first method returns the value of the first element.

Since 0.01

first example 1

# given: synopsis;

my $first = $array->first;

# 1

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;

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

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

# 1

ge example 2

package main;

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

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

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

# 0

ge example 3

package main;

use Venus::Array;
use Venus::Float;

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

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

# 1

ge example 4

package main;

use Venus::Array;
use Venus::Hash;

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

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

# 0

ge example 5

package main;

use Venus::Array;
use Venus::Number;

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

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

# 1

ge example 6

package main;

use Venus::Array;
use Venus::Regexp;

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

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

# 0

ge example 7

package main;

use Venus::Array;
use Venus::Scalar;

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

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

# 0

ge example 8

package main;

use Venus::Array;
use Venus::String;

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

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

# 1

ge example 9

package main;

use Venus::Array;
use Venus::Undef;

my $lvalue = Venus::Array->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;

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

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

# 0

gele example 2

package main;

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

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

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

# 0

gele example 3

package main;

use Venus::Array;
use Venus::Float;

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

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

# 0

gele example 4

package main;

use Venus::Array;
use Venus::Hash;

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

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

# 0

gele example 5

package main;

use Venus::Array;
use Venus::Number;

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

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

# 0

gele example 6

package main;

use Venus::Array;
use Venus::Regexp;

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

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

# 0

gele example 7

package main;

use Venus::Array;
use Venus::Scalar;

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

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

# 0

gele example 8

package main;

use Venus::Array;
use Venus::String;

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

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

# 0

gele example 9

package main;

use Venus::Array;
use Venus::Undef;

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

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

# 0

grep

grep(coderef $code) (arrayref)

The grep method executes a callback for each element in the array passing the value as an argument, returning a new array reference containing the elements for which the returned true. This method can return a list of values in list-context.

Since 0.01

grep example 1

# given: synopsis;

my $grep = $array->grep(sub {
  $_ > 3
});

# [4..9]

grep example 2

# given: synopsis;

my $grep = $array->grep(sub {
  my ($key, $value) = @_;

  $value > 3
});

# [4..9]

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;

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

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

# 0

gt example 2

package main;

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

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

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

# 0

gt example 3

package main;

use Venus::Array;
use Venus::Float;

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

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

# 1

gt example 4

package main;

use Venus::Array;
use Venus::Hash;

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

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

# 0

gt example 5

package main;

use Venus::Array;
use Venus::Number;

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

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

# 1

gt example 6

package main;

use Venus::Array;
use Venus::Regexp;

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

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

# 0

gt example 7

package main;

use Venus::Array;
use Venus::Scalar;

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

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

# 0

gt example 8

package main;

use Venus::Array;
use Venus::String;

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

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

# 1

gt example 9

package main;

use Venus::Array;
use Venus::Undef;

my $lvalue = Venus::Array->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;

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

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

# 0

gtlt example 2

package main;

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

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

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

# 0

gtlt example 3

package main;

use Venus::Array;
use Venus::Float;

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

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

# 0

gtlt example 4

package main;

use Venus::Array;
use Venus::Hash;

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

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

# 0

gtlt example 5

package main;

use Venus::Array;
use Venus::Number;

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

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

# 0

gtlt example 6

package main;

use Venus::Array;
use Venus::Regexp;

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

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

# 0

gtlt example 7

package main;

use Venus::Array;
use Venus::Scalar;

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

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

# 0

gtlt example 8

package main;

use Venus::Array;
use Venus::String;

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

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

# 0

gtlt example 9

package main;

use Venus::Array;
use Venus::Undef;

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

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

# 0

iterator

iterator() (coderef)

The iterator method returns a code reference which can be used to iterate over the array. Each time the iterator is executed it will return the next element in the array until all elements have been seen, at which point the iterator will return an undefined value. This method can return a tuple with the key and value in list-context.

Since 0.01

iterator example 1

# given: synopsis;

my $iterator = $array->iterator;

# sub { ... }

# while (my $value = $iterator->()) {
#   say $value; # 1
# }

iterator example 2

# given: synopsis;

my $iterator = $array->iterator;

# sub { ... }

# while (grep defined, my ($key, $value) = $iterator->()) {
#   say $value; # 1
# }

join

join(string $seperator) (string)

The join method returns a string consisting of all the elements in the array joined by the join-string specified by the argument. Note: If the argument is omitted, an empty string will be used as the join-string.

Since 0.01

join example 1

# given: synopsis;

my $join = $array->join;

# 123456789

join example 2

# given: synopsis;

my $join = $array->join(', ');

# "1, 2, 3, 4, 5, 6, 7, 8, 9"

keyed

keyed(string @keys) (hashref)

The keyed method returns a hash reference where the arguments become the keys, and the elements of the array become the values.

Since 0.01

keyed example 1

package main;

use Venus::Array;

my $array = Venus::Array->new([1..4]);

my $keyed = $array->keyed('a'..'d');

# { a => 1, b => 2, c => 3, d => 4 }

keys

keys() (arrayref)

The keys method returns an array reference consisting of the indicies of the array.

Since 0.01

keys example 1

# given: synopsis;

my $keys = $array->keys;

# [0..8]

last

last() (any)

The last method returns the value of the last element in the array.

Since 0.01

last example 1

# given: synopsis;

my $last = $array->last;

# 9

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;

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

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

# 1

le example 2

package main;

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

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

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

# 1

le example 3

package main;

use Venus::Array;
use Venus::Float;

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

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

# 0

le example 4

package main;

use Venus::Array;
use Venus::Hash;

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

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

# 0

le example 5

package main;

use Venus::Array;
use Venus::Number;

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

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

# 0

le example 6

package main;

use Venus::Array;
use Venus::Regexp;

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

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

# 1

le example 7

package main;

use Venus::Array;
use Venus::Scalar;

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

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

# 0

le example 8

package main;

use Venus::Array;
use Venus::String;

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

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

# 0

le example 9

package main;

use Venus::Array;
use Venus::Undef;

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

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

# 0

length

length() (number)

The length method returns the number of elements within the array, and is an alias for the "count" method.

Since 0.08

length example 1

# given: synopsis;

my $length = $array->length;

# 9

list

list() (any)

The list method returns a shallow copy of the underlying array reference as an array reference.

Since 0.01

list example 1

# given: synopsis;

my $list = $array->list;

# 9

list example 2

# given: synopsis;

my @list = $array->list;

# (1..9)

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;

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

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

# 0

lt example 2

package main;

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

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

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

# 1

lt example 3

package main;

use Venus::Array;
use Venus::Float;

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

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

# 0

lt example 4

package main;

use Venus::Array;
use Venus::Hash;

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

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

# 0

lt example 5

package main;

use Venus::Array;
use Venus::Number;

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

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

# 0

lt example 6

package main;

use Venus::Array;
use Venus::Regexp;

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

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

# 1

lt example 7

package main;

use Venus::Array;
use Venus::Scalar;

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

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

# 0

lt example 8

package main;

use Venus::Array;
use Venus::String;

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

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

# 0

lt example 9

package main;

use Venus::Array;
use Venus::Undef;

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

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

# 0

map

map(coderef $code) (arrayref)

The map method iterates over each element in the array, executing the code reference supplied in the argument, passing the routine the value at the current position in the loop and returning a new array reference containing the elements for which the argument returns a value or non-empty list. This method can return a list of values in list-context.

Since 0.01

map example 1

# given: synopsis;

my $map = $array->map(sub {
  $_ * 2
});

# [2, 4, 6, 8, 10, 12, 14, 16, 18]

map example 2

# given: synopsis;

my $map = $array->map(sub {
  my ($key, $value) = @_;

  [$key, ($value * 2)]
});

# [
#   [0, 2],
#   [1, 4],
#   [2, 6],
#   [3, 8],
#   [4, 10],
#   [5, 12],
#   [6, 14],
#   [7, 16],
#   [8, 18],
# ]

merge

merge(arrayref @data) (arrayref)

The merge method returns an array reference where the elements in the array and the elements in the argument(s) are merged. This operation performs a deep merge and clones the datasets to ensure no side-effects.

Since 3.30

merge example 1

# given: synopsis;

my $merge = $array->merge([10..15]);

# [10..15,7,8,9]

merge example 2

# given: synopsis;

my $merge = $array->merge([1,2,{1..4},4..9]);

# [1,2,{1..4},4..9]

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;

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

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

# 0

ne example 2

package main;

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

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

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

# 1

ne example 3

package main;

use Venus::Array;
use Venus::Float;

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

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

# 1

ne example 4

package main;

use Venus::Array;
use Venus::Hash;

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

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

# 1

ne example 5

package main;

use Venus::Array;
use Venus::Number;

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

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

# 1

ne example 6

package main;

use Venus::Array;
use Venus::Regexp;

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

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

# 1

ne example 7

package main;

use Venus::Array;
use Venus::Scalar;

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

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

# 1

ne example 8

package main;

use Venus::Array;
use Venus::String;

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

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

# 1

ne example 9

package main;

use Venus::Array;
use Venus::Undef;

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

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

# 1

none

none(coderef $code) (boolean)

The none method returns true if none of the elements in the array meet the criteria set by the operand and rvalue.

Since 0.01

none example 1

# given: synopsis;

my $none = $array->none(sub {
  $_ < 1
});

# 1

none example 2

# given: synopsis;

my $none = $array->none(sub {
  my ($key, $value) = @_;

  $value < 1
});

# 1

one

one(coderef $code) (boolean)

The one method returns true if only one of the elements in the array meet the criteria set by the operand and rvalue.

Since 0.01

one example 1

# given: synopsis;

my $one = $array->one(sub {
  $_ == 1
});

# 1

one example 2

# given: synopsis;

my $one = $array->one(sub {
  my ($key, $value) = @_;

  $value == 1
});

# 1

order

order(number @indices) (Venus::Array)

The order method reorders the array items based on the indices provided and returns the invocant.

Since 2.01

order example 1

# given: synopsis;

my $order = $array->order;

# bless({ value => [1..9] }, "Venus::Array")

order example 2

# given: synopsis;

my $order = $array->order(8,7,6);

# bless({ value => [9,8,7,1,2,3,4,5,6] }, "Venus::Array")

order example 3

# given: synopsis;

my $order = $array->order(0,2,1);

# bless({ value => [1,3,2,4,5,6,7,8,9] }, "Venus::Array")

pairs

pairs() (arrayref)

The pairs method is an alias to the pairs_array method. This method can return a list of values in list-context.

Since 0.01

pairs example 1

# given: synopsis;

my $pairs = $array->pairs;

# [
#   [0, 1],
#   [1, 2],
#   [2, 3],
#   [3, 4],
#   [4, 5],
#   [5, 6],
#   [6, 7],
#   [7, 8],
#   [8, 9],
# ]

part

part(coderef $code) (tuple[arrayref, arrayref])

The part method iterates over each element in the array, executing the code reference supplied in the argument, using the result of the code reference to partition to array into two distinct array references. This method can return a list of values in list-context.

Since 0.01

part example 1

# given: synopsis;

my $part = $array->part(sub {
  $_ > 5
});

# [[6..9], [1..5]]

part example 2

# given: synopsis;

my $part = $array->part(sub {
  my ($key, $value) = @_;

  $value < 5
});

# [[1..4], [5..9]]

path

path(string $expr) (any)

The path method traverses the data structure using the path expr provided, returning the value found or undef. In list-context, this method returns a tuple, i.e. the value found and boolean representing whether the match was successful.

Since 0.01

path example 1

package main;

use Venus::Array;

my $array = Venus::Array->new([{'foo' => {'bar' => 'baz'}}, 'bar', ['baz']]);

my $path = $array->path('/0/foo');

# { bar => "baz" }

path example 2

package main;

use Venus::Array;

my $array = Venus::Array->new([{'foo' => {'bar' => 'baz'}}, 'bar', ['baz']]);

my $path = $array->path('/0/foo/bar');

# "baz"

path example 3

package main;

use Venus::Array;

my $array = Venus::Array->new([{'foo' => {'bar' => 'baz'}}, 'bar', ['baz']]);

my $path = $array->path('/2/0');

# "baz"

path example 4

package main;

use Venus::Array;

my $array = Venus::Array->new([{'foo' => {'bar' => 'baz'}}, 'bar', ['baz']]);

my @path = $array->path('/3/0');

# (undef, 0)

pop

pop() (any)

The pop method returns the last element of the array shortening it by one. Note, this method modifies the array.

Since 0.01

pop example 1

# given: synopsis;

my $pop = $array->pop;

# 9

push

push(any @data) (arrayref)

The push method appends the array by pushing the agruments onto it and returns itself.

Since 0.01

push example 1

# given: synopsis;

my $push = $array->push(10);

# [1..10]

puts

puts(any @args) (arrayref)

The puts method select values from within the underlying data structure using "path" in Venus::Array, optionally assigning the value to the preceeding scalar reference and returns all the values selected.

Since 3.20

puts example 1

package main;

use Venus::Array;

my $array = Venus::Array->new([
  {
    fruit => "apple",
    size => "small",
    color => "red",
  },
  {
    fruit => "lemon",
    size => "large",
    color => "yellow",
  },
]);

my $puts = $array->puts(undef, '0.fruit', undef, '1.fruit');

# ["apple", "lemon"]

puts example 2

package main;

use Venus::Array;

my $array = Venus::Array->new([
  {
    fruit => "apple",
    size => "small",
    color => "red",
  },
  {
    fruit => "lemon",
    size => "large",
    color => "yellow",
  },
]);

$array->puts(\my $fruit1, '0.fruit', \my $fruit2, '1.fruit');

my $puts = [$fruit1, $fruit2];

# ["apple", "lemon"]

puts example 3

package main;

use Venus::Array;

my $array = Venus::Array->new([
  {
    fruit => "apple",
    size => "small",
    color => "red",
  },
  {
    fruit => "lemon",
    size => "large",
    color => "yellow",
  },
]);

$array->puts(
  \my $fruit1, '0.fruit',
  \my $fruit2, '1.fruit',
  \my $fruit3, '2.fruit',
);

my $puts = [$fruit1, $fruit2, $fruit3];

# ["apple", "lemon", undef]

puts example 4

package main;

use Venus::Array;

my $array = Venus::Array->new([1..20]);

$array->puts(
  \my $a, '0',
  \my $b, '1',
  \my $m, ['', '2:-2'],
  \my $x, '18',
  \my $y, '19',
);

my $puts = [$a, $b, $m, $x, $y];

# [1, 2, [3..18], 19, 20]

random

random() (any)

The random method returns a random element from the array.

Since 0.01

random example 1

# given: synopsis;

my $random = $array->random;

# 2

# my $random = $array->random;

# 1

range

range(number | string @args) (arrayref)

The range method accepts a "range expression" and returns the result of calling the "slice" method with the computed range.

Since 2.55

range example 1

# given: synopsis

package main;

my $range = $array->range;

# []

range example 2

# given: synopsis

package main;

my $range = $array->range(0);

# [1]

range example 3

# given: synopsis

package main;

my $range = $array->range('0:');

# [1..9]

range example 4

# given: synopsis

package main;

my $range = $array->range(':4');

# [1..5]

range example 5

# given: synopsis

package main;

my $range = $array->range('8:');

# [9]

range example 6

# given: synopsis

package main;

my $range = $array->range('4:');

# [5..9]

range example 7

# given: synopsis

package main;

my $range = $array->range('0:2');

# [1..3]

range example 8

# given: synopsis

package main;

my $range = $array->range('2:4');

# [3..5]

range example 9

# given: synopsis

package main;

my $range = $array->range(0..3);

# [1..4]

range example 10

# given: synopsis

package main;

my $range = $array->range('-1:8');

# [9,1..9]

range example 11

# given: synopsis

package main;

my $range = $array->range('0:8');

# [1..9]

range example 12

# given: synopsis

package main;

my $range = $array->range('0:-2');

# [1..7]

range example 13

# given: synopsis

package main;

my $range = $array->range('-2:-2');

# [8]

range example 14

# given: synopsis

package main;

my $range = $array->range('0:-20');

# []

range example 15

# given: synopsis

package main;

my $range = $array->range('-2:-20');

# []

range example 16

# given: synopsis

package main;

my $range = $array->range('-2:-6');

# []

range example 17

# given: synopsis

package main;

my $range = $array->range('-2:-8');

# []

range example 18

# given: synopsis

package main;

my $range = $array->range('-2:-9');

# []

range example 19

# given: synopsis

package main;

my $range = $array->range('-5:-1');

# [5..9]

reverse

reverse() (arrayref)

The reverse method returns an array reference containing the elements in the array in reverse order.

Since 0.01

reverse example 1

# given: synopsis;

my $reverse = $array->reverse;

# [9, 8, 7, 6, 5, 4, 3, 2, 1]

rotate

rotate() (arrayref)

The rotate method rotates the elements in the array such that first elements becomes the last element and the second element becomes the first element each time this method is called.

Since 0.01

rotate example 1

# given: synopsis;

my $rotate = $array->rotate;

# [2..9, 1]

rsort

rsort() (arrayref)

The rsort method returns an array reference containing the values in the array sorted alphanumerically in reverse.

Since 0.01

rsort example 1

# given: synopsis;

my $rsort = $array->rsort;

# [9, 8, 7, 6, 5, 4, 3, 2, 1]

shift

shift() (any)

The shift method returns the first element of the array shortening it by one.

Since 0.01

shift example 1

# given: synopsis;

my $shift = $array->shift;

# 1

shuffle

shuffle() (arrayref)

The shuffle method returns an array with the items in a randomized order.

Since 1.40

shuffle example 1

# given: synopsis

package main;

my $shuffle = $array->shuffle;

# [4, 5, 8, 7, 2, 9, 6, 3, 1]

slice

slice(string @keys) (arrayref)

The slice method returns a hash reference containing the elements in the array at the index(es) specified in the arguments.

Since 0.01

slice example 1

# given: synopsis;

my $slice = $array->slice(2, 4);

# [3, 5]

sort

sort() (arrayref)

The sort method returns an array reference containing the values in the array sorted alphanumerically.

Since 0.01

sort example 1

package main;

use Venus::Array;

my $array = Venus::Array->new(['d','c','b','a']);

my $sort = $array->sort;

# ["a".."d"]

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;

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

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

# 1

tv example 2

package main;

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

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

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

# 0

tv example 3

package main;

use Venus::Array;
use Venus::Float;

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

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

# 0

tv example 4

package main;

use Venus::Array;
use Venus::Hash;

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

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

# 0

tv example 5

package main;

use Venus::Array;
use Venus::Number;

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

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

# 0

tv example 6

package main;

use Venus::Array;
use Venus::Regexp;

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

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

# 0

tv example 7

package main;

use Venus::Array;
use Venus::Scalar;

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

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

# 0

tv example 8

package main;

use Venus::Array;
use Venus::String;

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

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

# 0

tv example 9

package main;

use Venus::Array;
use Venus::Undef;

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

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

# 0

unique

unique() (arrayref)

The unique method returns an array reference consisting of the unique elements in the array.

Since 0.01

unique example 1

package main;

use Venus::Array;

my $array = Venus::Array->new([1,1,1,1,2,3,1]);

my $unique = $array->unique;

# [1, 2, 3]

unshift

unshift(any @data) (arrayref)

The unshift method prepends the array by pushing the agruments onto it and returns itself.

Since 0.01

unshift example 1

# given: synopsis;

my $unshift = $array->unshift(-2,-1,0);

# [-2..9]

AUTHORS

Awncorp, awncorp@cpan.org

LICENSE

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

To install Venus, copy and paste the appropriate command in to your terminal.

cpanm

cpanm Venus

CPAN shell

perl -MCPAN -e shell
install Venus

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)

NAME

ABSTRACT

SYNOPSIS

DESCRIPTION

INHERITS

INTEGRATES

METHODS

all

any

call

cast

count

default

delete

each

empty

eq

exists

find

first

ge

gele

grep

gt

gtlt

iterator

join

keyed

keys

last

le

length

list

lt

map

merge

ne

none

one

order

pairs

part

path

pop

push

puts

random

range

reverse

rotate

rsort

shift

shuffle

slice

sort

tv

unique

unshift

AUTHORS

LICENSE

Module Install Instructions