Arrays:  


Arrays

Arrays are used to store sequences of variables, or elements. An element within an array is accessed by indexing the array with an integer offset.

The general syntax for indexing an array is:

ArrayExpression [ index1 , index2 etc... ]

Creating Arrays

The most common way to create an array is when declaring a variable:

Local int_array[10]
This will initialize the int_array variable with a 10 element array. You can declare an 'empty' array by using []:
Local int_array[]
An empty array is identical to an array with 0 elements.

Arrays may also be created 'on the fly' using the syntax:

New [ Dimension1 , Dimension2 etc... ]
This returns an array of the specified dimension(s) with each element initialized to Null. For example:
Local int_array:Int[]
int_array=New Int[10]
'Auto arrays' may be created using the syntax:
[ Element1 , Element2 etc... ]
This returns a 1 dimensional array containing the specified elements, for example:
Local int_array[]=[1,2,3,4,5]
Each element of an auto array must have exactly the same type. If necessary, you can use type conversions to enforce this.

Arrays also provide the following methods:

MethodDescription
Sort( ascending=True )Sort the array.
Dimensions:Int[]()Get array dimensions.

Arrays also provide a read-only length field that returns the total number of elements in the array.

Here are some examples of using array methods:

Strict

Local arr:String[]=["some","random","strings","in","a","string","array"]

arr.Sort        'sort ascending
Print "Array in ascending order..."
For Local t:String=EachIn arr
        Print t
Next

arr.Sort False  'sort descending
Print "Array in descending order..."
For Local t:String=EachIn arr
        Print t
Next

Local arr2[10,20,30,40]

'Dump array dimensions
For Local i=EachIn arr2.Dimensions()
	Print i
Next