SPVM::IntList - Dynamic int Array
use IntList; # Create a int list my $list = IntList->new; my $list = IntList->new([(int)1, 2, 3]); # Create a int list with array length my $list = IntList->new_len(10); # Get list length my $length = $list->length; # Push value $list->push((int)3); # Pop value. my $element = $list->pop; # Unshift value. $list->unshift((int)3); # Shift value. my $element = $list->shift; # Set value. $list->set(2, (int)3); # Get value. my $element = $list->get(2); # Insert value $list->insert(1, 3); # Remove value my $element = $list->remove(1); # Convert list to array. my $array = $list->to_array;
IntList is a dynamic int array.
IntList
int
enum { DEFAULT_CAPACITY = 4, }
The default capacity. The value is 4.
has capacity : ro int;
The capacity. This is the length of the internally reserved elements to extend the length of the list.
has length : ro int;
The length of the list.
has values : ro int[];
The elements of the list. This is the internally used array, but it can be manipulated directly.
my $elements = $list->values; $valeus->[0] = 5;
static method new : IntList ($array = undef : int[], $capacity = -1 : int);
Create a new IntList object using "new_len".
The passed length to "new_len" is the length of the array. If the array is undef, the length is 0.
The elements of the array are copied to the values of the the created array.
Examples:
my $list = IntList->new; my $list = IntList->new([(int)1, 2, 3]);
static method new_len : IntList ($length : int, $capacity = -1 : int);
Creates a new IntList object with the $length and the $capacity.
If the $capacity is less than 0, the capacity is set to the value of "DEFAULT_CAPACITY".
If the $length is greater than the $capacity, the $capacity is set to the $length.
Exceptions:
The $length must be greater than or equal to 0.
method get : int ($index : int);
Gets the element of the position of the $index.
The $index must be greater than or equal to 0.
The $index must be less than the length of the $list.
method insert : void ($index : int, $element : int);
Inserts an $element to the position of the $index.
The $index must be less than or equal to the length of the $list.
method pop : int ();
Removes the last element and return it.
The length of the $list must be greater than 0.
method push : void ($element : int);
Adds an $element after the end of the list.
method remove : int ($index : int);
Removes the element at the position of the $index and return it.
method replace : void ($offset : int, $remove_length : int, $replace : int[]);
Replaces the elements of the range specified by the $offset and the $lenght with the $replace array.
The $offset must be greater than or equal to 0.
The $remove_length must be greater than or equal to 0.
The $offset + the $removing lenght must be less than or equal to the length of the $list.
method reserve : void ($new_capacity : int);
Reserves the elements with the $new_capacity.
If the $new_capacity is greater than the capacity of the list, the capacity of the list is extended to the $new_capacity.
Note that "values" is replaced with the new values and the values of the original list are copied to the new values in the above case.
The $new_capacity must be greater than or equal to 0.
method resize : void ($new_length : int);
Resize the list with the $new_length.
The $new_length must be greater than or equal to 0.
method set : void ($index : int, $element : int);
Sets the $element at the position of the $index.
method set_array : void ($array : int[]);
Sets an $array. Each element of the $array is copied to the element of the list.
The $array must be defined.
The length of the $array must be the $same as the length of the $list.
method shift : int ();
Removes the first element and return it.
method to_array : int[] ();
Converts the list to an array.
method unshift : void ($element : int);
Inserts an $element at the beginning of the list.
Copyright (c) 2023 Yuki Kimoto
MIT License
To install SPVM, copy and paste the appropriate command in to your terminal.
cpanm
cpanm SPVM
CPAN shell
perl -MCPAN -e shell install SPVM
For more information on module installation, please visit the detailed CPAN module installation guide.