Name
SPVM::List - Dynamic Object Array
Usage
use List;
# Create a object list
my $list = List->new;
my $list = List->new([(object)Byte->new(1), Int->new(2), Long->new(3)]);
# Create a Int list
my $list = List->new([Int->new(1), Int->new(2), Int->new(3)]);
# Create a object list with length
my $list = List->new_len([], 3);
# Create a Int list with length
my $list = List->new_len(new Int[0], 3);
# Get list length
my $length = $list->length;
# Push object value
$list->push(Int->new(3));
# Pop object value.
my $element = $list->pop;
# Unshift object value.
$list->unshift(Int->new(3));
# Shift object value.
my $element = $list->shift;
# Set object value.
$list->set(2, Int->new(3));
# Get object value.
my $element = $list->get(2);
# Insert object value
$list->insert(1, Int->new(3));
# Remove object value
my $element = $list->remove(1);
# Convert List to object array.
my $int_array = $list->to_array;
# Convert List to Int array.
my $int_array = (Int[])$list->to_array;Description
List is the dynamic object array that has a specified object array type.
Enumerations
enum {
DEFAULT_CAPACITY = 4,
}DEFAULT_CAPACITY
The default capacity. The value is 4.
Fields
capacity
has capacity : ro int;The capacity. This is the length of the internally reserved elements to extend the length of the list.
length
has length : ro int;The length of the list.
Class Methods
new
static method new : List ($array : object[] = undef, $capacity : int = -1);
Creates a new List object using "new_len".
The passed length to "new_len" is the length of $array. If the array is undef, the length is 0.
The element's addresses of the object array are copied to the elements of the the created array.
# object[]
my $list = List->new([(object)Byte->new(1), Int->new(2), Long->new(3)]);
# Int[]
my $list = List->new([Int->new(1), Int->new(2), Int->new(3)]);new_len
static method new_len : List ($proto_array : object[], $length : int, $capacity : int = -1);
Creates a new StringList object with $protot_array, $length and $capacity.
If $protot_array is undefined, $protot_array is set to an object[] object.
If $capacity is less than 0, $capacity is set to the value of "DEFAULT_CAPACITY".
If $length is greater than $capacity, $capacity is set to the length.
Exceptions:
$length must be greater than or equal to 0. Otherwise an exception is thrown.
Examples:
# Create a Int list with length
my $list = List->new_len(new Int[0], 3);Instance Methods
get
method get : object ($index : int);
Gets the element of the position of $index.
Exceptions:
$index must be greater than or equal to 0. Otherwise an exception is thrown.
$index must be less than the length of $list. Otherwise an exception is thrown.
insert
method insert : void ($index : int, $element : object);
Inserts an $element to the position of $index.
Exceptions:
$index must be greater than or equal to 0. Otherwise an exception is thrown.
$index must be less than or equal to the length of $list. Otherwise an exception is thrown.
pop
method pop : object ();
Removes the last element and return it.
Exceptions:
The length of $list must be greater than 0. Otherwise an exception is thrown.
push
method push : void ($element : object);
Adds an $element after the end of the list.
remove
method remove : object ($index : int);
Removes the element at the position of $index and return it.
Exceptions:
$index must be greater than or equal to 0. Otherwise an exception is thrown.
$index must be less than the length of $list. Otherwise an exception is thrown.
replace
method replace : void ($offset : int, $remove_length : int, $replace : string[]);
Replaces the elements of the range specified by $offset and $lenght with $replace array.
Exceptions:
$offset must be greater than or equal to 0. Otherwise an exception is thrown.
$remove_length must be greater than or equal to 0. Otherwise an exception is thrown.
$offset + $removing lenght must be less than or equal to the length of $list. Otherwise an exception is thrown.
reserve
method reserve : void ($new_capacity : int);
Reserves the elements with $new_capacity.
If $new_capacity is greater than the capacity of the list, the capacity of the list is extended to $new_capacity.
Exceptions:
$new_capacity must be greater than or equal to 0. Otherwise an exception is thrown.
resize
method resize : void ($new_length : int);
Resize the list with $new_length.
Exceptions:
$new_length must be greater than or equal to 0. Otherwise an exception is thrown.
replace
method replace : void ($offset : int, $remove_length : int, $replace : object[]);
Replaces the elements of the range specified by $offset and $remove_length with the replacement array.
Exceptions:
$offset must be greater than or equal to 0. Otherwise an exception is thrown.
$remove_length must be greater than or equal to 0. Otherwise an exception is thrown.
$offset + $removing lenght must be less than or equal to the length of $list. Otherwise an exception is thrown.
set
method set : void ($index : int, $element : object);
Sets $element at the position of $index.
Exceptions:
$index must be greater than or equal to 0. Otherwise an exception is thrown.
$index must be less than the length of $list. Otherwise an exception is thrown.
set_array
method set_array : void ($array : object[]);
Sets an $array. Each element of $array is copied to the element of the list.
Exceptions:
$array must be defined. Otherwise an exception is thrown.
The length of $array must be equal to the length of $list. Otherwise an exception is thrown.
shift
method shift : object ();
Removes the first element and return it.
Exceptions:
The length of $list must be greater than 0. Otherwise an exception is thrown.
to_array
method to_array : object[] ();
Creates a new array and copies all elements of the list into the new array, and returns it.
get_array_unsafe
method get_array_unsafe : object[] ();
Gets the internally array.
This array is unsafe because it continues to point to the old array if the internal array is extended.
unshift
method unshift : void ($element : object);
Inserts an $element at the beginning of the list.
Copyright & License
Copyright (c) 2023 Yuki Kimoto
MIT License