/ 
SPVM-0.9126
River stage two • 34 direct dependents • 37 total dependents
/ SPVM::LongList

NAME

SPVM::LongList - LongList in SPVM | Dynamic long array

SYNOPSYS

use LongList;

# Create a long list
my $long_list = LongList->new_len(10);

# Create a long list with array
my $long_list = LongList->new([(long)1, 2, 3]);

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

# Push long value
$long_list->push(3L);

# Pop long value.
my $long_value = $long_list->pop;

# Unshift long value.
$long_list->unshift(3L);

# Shift long value.
my $long_value = $long_list->shift;

# Set long value.
$long_list->set(2, 3L);

# Get long value.
my $long_value = $long_list->get(2);

# Insert long value
$long_list->insert(1, 3);

# Remove long value
my $long_value = $long_list->remove(1);

# Convert LongList to long array.
my $long_array = $long_list->to_array;

DESCRIPTION

LongList is dynamic long array.

CLASS METHODS

new

static method new : LongList ($array : long[])

Create a new LongList object with specific long array.

Internally, new array is created, and each element of argument array is copied to internal array.

If array is undef, 0-length internal array is created.

new_len

static method new_len : LongList ($length : int)

Create a new LongList object with array length.

INSTANCE METHODS

get

method get : long ($index : int)

Get the value with index.

insert

method insert : void ($index : int, $value : long)

Insert a element to the specific index.

length

static method length : int ()

Get list length.

pop

method pop : long ()

Pops and returns the last value of the list, shortening the array by one element If there are no elements in the list, exception occur.

push

method push : void ($value : long)

Appending the value to the end of list.

remove

method remove : long ($index : int)

Remove and return the element which is specified by the index.

resize

method resize : void ($new_length : int)

Resize this list. If the new length is shorter than the current length, the list is truncated to the new length. If the new length is shorter than the current length, the list is truncated to the new length. If the new length is same as the current length, there is nothing to do. If the new length is longer than the current length, the list grows to the new length, and the values of the added elements are set to 0.

New length must be more than or equals to 0, otherwise a exception occur.

set

method set : void ($index : int, $value : long)

Set the value with index.

set_array

method set_array : void ($array : long[])

Set a array. Each elements of the array is copied to the correspoinding index of the array this list has.

Array must be defined, otherwise a exception occurs.

The length of argument array must be same as the length of current list array, otherwise a exception occures.

shift

method shift : long ()

Shifts the first value of the list off and returns it, shortening the array by 1 and moving everything down. If there are no elements in the list, exception occur.

to_array

method to_array : long[] ()

Convert LongList to long array.

unshift

method unshift : void ($value : long)

Appending the value to the top of list.