8.3.2 Array Functions

Alloc (int x)
Allocates an array with space for x items.
Reset()
Sets the size of the array to zero, but does not change or free the amount to allocated space.
Remove(int x)
Removes the array element at index x.
Permute()
Permutes the elements of the array into a random order.
Sort()
Sorts the array in ascending order.
ShiftLeft (int x)
Shifts all the elements in the array x positions to the left.
ShiftLeftPct (float f)
Shifts the array to the left by f percent.
El (int x)
Returns the element at index x, or err if out of range. Indexing starts at zero, therefore an array with five elements would have valid indices for zero to four.
FastEl (int x)
Fast element return. Returns the element at index x with no error checking. Caution: PDP++ may behave unexpectedly if this function is called with an index that is out of range.
Pop()
Returns and removes the last element in the array.
Peek()
Returns the last element in the array without removing it.
Add (item i)
Adds i to the array.
Push (item i)
Pushes (adds) i to the the end of the array
Insert (item i, int num, int loc)
Inserts num copies of item i at location loc in the array.
Find (item i, int loc)
Returns the index of the first element in the array matching item i starting at location loc.
RemoveEl (item i)
Removes the first element matching item i. Returns TRUE if a match is found and FALSE otherwise.