#-*-cperl-*-

=head1 Array PMC

Implementation of a generic array. Each cell can contain any atomic
data.

=head2 Creation

To create a PMC array use

   new P0, .Array

And P0 will contain your array object.

=head2 Size

You can check a PMC array size using

   set I0, P0

and I0 will contain the array size;

=head2 Access Elements

You can create an empty element using

   set P0, 1

which changes the array size, but not stores any value.

To store the value C<-7> on first position, use

   set P0[0], -7

Notice that array indexes start at 0 as Perl or C.

To get the value from that position, use

   set I1, P0[0]

where the last parameter is the index we are using.

Meanwhile, these arrays have fixed size, which means that you cannot
access elements outside of the bounds. When you set the size to one,
you only can store an element. To store another, you should resize the
array:

  set P0, 2
  set P0[1], 3

=head2 Data Types

Note that all examples are storing integers (so, using C<In>
registers). To use strings or numbers, you should use registers
C<Sn> and C<Nn>.

=cut