Name

SPVM::Immutable::StringList - Immutable string array

Usage

use Immutable::StringList;

# Create a string list
my $list = Immutable::StringList->new;
my $list = Immutable::StringList->new(["abc", "def", "ghi"]);

# Create a string list
my $list = Immutable::StringList->new_len(10);

# Get list length
my $length = $list->length;

# Get string value.
my $element = $list->get(2);

# Convert Immutable::StringList to string array.
my $array = $list->to_array;

Description

The Immutable::StringList class has methods to manipulate an immutable string array.

Fields

length

has length : ro int;

Gets the length field.

This field is the length of the elements of the list.

Class Methods

new

static method new : Immutable::StringList ($array : string[] = undef);

Create a new Immutable::StringList 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 each string of the array is copied and to each value of the the created array and each string is made read-only.

Examples:

my $list = Immutable::StringList->new;
my $list = Immutable::StringList->new(["abc", "def", "ghi"]);

new_len

static method new_len : Immutable::StringList ($length : int);

Creates a new Immutable::StringList object with the $length.

Exceptions:

The $length must be greater than or equal to 0. Otherwize an exception is thrown.

Instance Methods

get

method get : string ($index : int);

Gets the element of the position of the $index.

Exceptions:

The $index must be greater than or equal to 0. Otherwize an exception is thrown.

The $index must be less than the length of the $list. Otherwize an exception is thrown.

to_array

method to_array : string[] ();

Converts the list to an array.

Copyright & License

Copyright (c) 2023 Yuki Kimoto

MIT License