Name
SPVM::StringList - Dynamic string array
Usage
use StringList;
# Create a string list
my $list = StringList->new;
my $list = StringList->new(["abc", "def", "ghi"]);
# Create a string list
my $list = StringList->new_len(10);
# Get list length
my $length = $list->length;
# Push string value
$list->push("abc");
# Pop string value.
my $value = $list->pop;
# Unshift string value.
$list->unshift("abc");
# Shift string value.
my $value = $list->shift;
# Set string value.
$list->set(2, "abc");
# Get string value.
my $value = $list->get(2);
# Insert string value
$list->insert(1, "abc");
# Remove string value
my $value = $list->remove(1);
# Convert StringList to string array.
my $array = $list->to_array;Description
StringList is a dynamic string array.
Fields
length
has length : ro int;The length.
values
has values : ro string[];The values. This is the internally used array, but it can be manipulated directly.
my $values = $list->values;
$valeus->[0] = "d";Class Methods
new
static method new : StringList ($array : string[]...)Create a new StringList object with a string array.
Internally, a new array is created, and each element of the specified array is copied to the new array.
If the array is undef, a new array that length is 0 is created.
Examples:
my $list = StringList->new;
my $list = StringList->new(["abc", "def", "ghi"]);
my $list = StringList->new(undef);new_len
static method new_len : StringList ($length : int)Create a new StringList object with the length.
The length must be greater than or equal to 0. Otherwise an excpetion will be thrown.
Instance Methods
get
method get : string ($index : int)Get the element of the position of the index.
The index must be greater than or equal to 0. Otherwise an excpetion will be thrown.
The index must be less than the length of the list. Otherwise an excpetion will be thrown.
insert
method insert : void ($index : int, $value : string)Insert an element to the position of the index.
The index must be greater than or equal to 0. Otherwise an excpetion will be thrown.
The index must be less than or equal to the length of the list. Otherwise an excpetion will be thrown.
pop
method pop : string ()Remove the last element and return it.
The length of the list must be greater than 0. Otherwise an excpetion will be thrown.
push
method push : void ($value : string)Add an element after the end of the list.
remove
method remove : string ($index : int)Remove the element at the position of the index and return it.
The index must be greater than or equal to 0. Otherwise an excpetion will be thrown.
The index must be less than the length of the list. Otherwise an excpetion will be thrown.
replace
method replace : void ($offset : int, $remove_length : int, $replace : string[])Replace the elements of the range specified by the offset and the lenght with the replacement array.
The offset must be greater than or equal to 0. Otherwise an excpetion will be thrown.
The removing length must be greater than or equal to 0. Otherwise an excpetion will be thrown.
The offset + the removing lenght must be less than or equal to the length of the list. Otherwise an excpetion will be thrown.
resize
method resize : void ($new_length : int)Resize the list.
The new length must be greater than or equal to 0. Otherwise an excpetion will be thrown.
set
method set : void ($index : int, $value : string)Set the element at the position of the index.
The index must be greater than or equal to 0. Otherwise an excpetion will be thrown.
The index must be less than the length of the list. Otherwise an excpetion will be thrown.
set_array
method set_array : void ($array : string[])Set a array. Each element of the array is copied to the element of the list.
The array must be defined. Otherwise an excpetion will be thrown.
The length of the array must be the same as the length of the list. Otherwise an excpetion will be thrown.
shift
method shift : string ()Remove the first element and return it.
The length of the list must be greater than 0. Otherwise an excpetion will be thrown.
to_array
method to_array : string[] ()Convert the list to an array.
unshift
method unshift : void ($value : string)Insert an element at the beginning of the list.