The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

SPVM::LongList - Continuous dynamic long array

SYNOPSYS

  use SPVM::LongList;
  
  # Create a long list
  my $long_list = SPVM::LongList->new;

  # Create a long list with array
  my $long_list = SPVM::LongList->newa([(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 SPVM::LongList to long array.
  my $long_array = $long_list->to_array;

DESCRIPTION

SPVM::LongList is continuous dynamic long array.

CLASS METHODS

new

    sub new : SPVM::LongList ()

Create a new SPVM::LongList object.

newa

    sub newa : SPVM::LongList ($array : long[])

Create a new SPVM::LongList object with specific long array.

INSTANCE METHODS

length

  sub length : int ()

Get list length.

push

  sub push : void ($self : self, $value : long)

Appending the value to the end of list.

pop

  sub pop : long ($self : self)

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.

unshift

  sub unshift : void ($self : self, $value : long)

Appending the value to the top of list.

shift

  sub shift : long ($self : self)

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.

set

  sub set : void ($self : self, $index : int, $value : long)

Set the value with index.

get

  sub get : long ($self : self, $index : int)

Get the value with index.

insert

  sub insert : void ($self : self, $index : int, $value : long)

Insert a element to the specific index.

remove

  sub remove : long ($self : self, $index : int)

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

to_array

  sub to_array : long[] ($self : self)

Convert SPVM::LongList to long array.