KIMOTO / SPVM-0.989026 / lib / SPVM / Immutable / LongList.pm 

            

              
1
2
3
—
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

              
package SPVM::Immutable::LongList;
1;
=head1 Name
SPVM::Immutable::LongList - Immutable long Array
=head1 Description
The Immutable::LongList class has methods to manipulate an immutable long array.
=head1 Usage
   
  use Immutable::LongList;
   
  # Create a long list
  my $list = Immutable::LongList->new;
  my $list = Immutable::LongList->new([(long)1, 2, 3]);
   
  # Create a long list with array length
  my $list = Immutable::LongList->new_len(10);
   
  # Get list length
  my $length = $list->length;
   
  # Get value.
  my $element = $list->get(2);
   
  # Convert list to array.
  my $array = $list->to_array;
   
=head1 Fields
=head2 length
  has length : ro int;
Gets the C<length> field.
This field is the length of the elements of the list.
=head1 Class Methods
=head2 new
  static method new : Immutable::LongList ($array : long[] = undef);
Create a new L<Immutable::LongList|SPVM::Immutable::LongList> object using L</"new_len">.
The passed length to L</"new_len"> is the length of the array. If the array is undef, the length is 0.
The elements of the array are copied to the elements of the the created array.
Examples:
  my $list = Immutable::LongList->new;
  my $list = Immutable::LongList->new([(long)1, 2, 3]);
=head2 new_len
  static method new_len : Immutable::LongList ($length : int);
Creates a new L<Immutable::LongList|SPVM::Immutable::LongList> object with the $length.
Exceptions:
The $length must be greater than or equal to 0. Otherwise an exception is thrown.
=head1 Instance Methods
=head2 get
  method get : long ($index : int);
Gets the element of the position of the $index.
Exceptions:
The $index must be greater than or equal to 0. Otherwise an exception is thrown.
The $index must be less than the length of the $list. Otherwise an exception is thrown.
=head2 to_array
  method to_array : long[] ();
Converts the list to an array.
=head1 Copyright & License
Copyright (c) 2023 Yuki Kimoto
MIT License