Bardolph Arrays
An array is declared with the define keyword. After it has been defined,
the elements can be accessed with numerical subscripts. The language
specification allows for arrays to have an arbitrary dimension.
The size and dimension of an array are static and set when the
array is declared. For example, to declare a one-dimensional vector:
define vector[5]
In this example, the array named vector has 5 elements and can be accessed with subscripts from 0 to 4.
Once an array is declared, it can be written with assign and read wherever
any other variable is allowed.
define hues[10]
assign hues[5] 120
hue hues[5]
Accessing an array with a subscript that is negative or outside the bounds of its size will cause an error to be logged, but in most cases, the virtual machine will make an attempt to provide a reasonable default. If the subscript is a floating-point value, the fraction will be truncated to yield an integer.
To declare a multi-dimensional array, use a series of square brackets, each with a size. For example:
define colors[8][4][9]
assign colors[1][3][8] 100
Within the declaration, the desired size of the array can be calculated at run-tme. As with other features of the language, numerical expressions need to be in curly braces.
define hue_array[{hue / 10}]
assign n {j + 5}
define int_array[n]
Assigning an array to a variable creates an alias and does not make a copy:
define mat[3]
assign mat[0] 100
assign mat2 mat
assign mat2[0] 200
# This will print 200
print mat[0]
When an array is partially subscripted, the result is itself an array with a reduced dimension.
Iterating Over an Array
To iterate over a specific range, use the repeat with construct:
To iterate over all of the elements in an array, use a repaeat in
as clause:
A similar construct can be used for multi-dimensional arrays: