Arrays

Name

Purpose

Arguments

Return value

Example

high

yields the index of the last array element  

if array is multi dimensional, the first index is used

1: array

INTEGER

i:=high (array);

length

yields the length of the array

1: array

INTEGER

a:array [1..10] of array [2..5] of integer;
b:array [1..10, 2..5] of integer;

e. g.  length(a)==length(b)==10

but length(a[1])==length(b[1])==4

low

yields the index of the first array element

1: array

INTEGER

i:=low (array);

Name

Purpose

Arguments

Return value

Example

append

appends an array or an array element to another array
Release 11: now allows to also append an individual element

1: array of: Dest=dyn. array
2: array or array element: Source

None

capacity

yields the maximal number of elements that a dynamic array can obtain without automatic memory allocation (does not necessary match the array length)

1: array: Source

INTEGER

 i:=capacity(arObjects);

copy

copies an array onto another one

1: array: Source

array of: Dest

high

yields the index of the last array element  

1: array of

INTEGER

i:=high (arObjects);

insert

inserts an array or an array element into another array at a certain position
Release 11: now allows to also insert an individual element

1: array of: Dest=dyn. array
2: array or array element: Source
3: INTEGER: Position

None

length

yields the length of the array

1: array of

INTEGER

low

yields the index of the first array element

1: array of

INTEGER

i:=low (arObjects);

remove

removes certain elements from an array

1: array of: dyn. array
2: INTEGER: Start Position
3: INTEGER: Number of Elements

None

reserve

allocates the storage space for a certain number of elements in an array (no elements are created or deleted, only the necessary storage is reserved)

1: array of: dyn. array
2: INTEGER: number of Elements

None

 reserve(arObjects,100);

setLength

sets the length of the array to a new value  

1: array of: dyn. array
2: INTEGER: new length

None

var dyn_arr: array of real;
setLength (dyn_arr, 2);
dyn_arr[0]:= -45.7;
dyn_arr[1]:=  5.7;

reserve

Release 11 allows minimum memory reservation for a given number of elements in an array (Please note: no elements are created or deleted, but only the required memory is reserved)  reserve does NOT replace the call to setLength) - this function can be used for long-term Optimization can be used to unnecessary Avoid reallocations of the array memory                 

1: dyn. array

2: INTEGER: Number of items to reserve

         begin
         setLength(arr, i+1);
         arr[i] := string(i);
         end;

         println("finished");

end.  

capacity

Release 11 returns the maximum number of elements the array can contain without automatically creating new memory

 1: dyn. array

 See reserve

Name

Purpose

Arguments

Return value

Example

setLow

Sets the index of the first element

1: array * of
2: INTEGER: new Index

array * of

procedure PrintCA (a: array * of char);
var k:integer;
begin
    print ("Char array of length ", length (a), ": ");
    for k := low  (a) to high (a) do
       print (k,":", a[k], ", ");
   print ("\n");
end;

var dyn_c: array of char;
begin 
   setLength (dyn_c, 5);
   dyn_c[0]:= 'x';  dyn_c[1]:= '真';
   dyn_c[2]:= 'ü';   dyn_c[3]:= '仿';
   dyn_c[4]:= 'ê';

    PrintCA (dyn_c);
    PrintCA (setlow (dyn_c,-10));
   PrintCA (sliceLeft (dyn_c,3));
   PrintCA (sliceRight(dyn_c,2));
   PrintCA (sliceMid  (dyn_c,1,4));
end.

sliceLeft

yields the n first elements of an array  

1: array
2: INTEGER: Number of Elements

array * of

sliceMid

yields the n elements of an array from a certain position onwards

1: array
2: INTEGER: First Index
3: INTEGER: Number of Elements

array * of

sliceRight

yields the n last elements of an array  

1: array
2: INTEGER: Number of Elements

array * of