View source for Multi-dimensional arrays

Multidimensional [[static arrays|static]] or [[dynamic arrays]] are not possible in UnrealScript. Neither are dynamic arrays of static arrays or vice versa.

==Workaround 1: Array of structs==
A good substitute are arrays of [[structs]] that contain an array as the only member. Such a declaration for a 10x10 two-dimensional static array might look as follows:
<uscript>
var struct {
  var int Y[10];
} X[10];
</uscript>
You would access individual elements through an expression that first accesses an element in the outer array of structs, and from there access an element of the struct member:
<uscript>
X[3].Y[5] = 23;
</uscript>

Of course you can also use dynamic arrays for the same example:
<uscript>
var array<struct {
  var array<int> Y;
}> X;
</uscript>
However, be careful when accessing elements. Accessing a struct member of an element in a dynamic array is a ''read'' access to the array. As a result, you cannot use the simple assignment as above, unless you know the outer array is already long enough. You need to ensure the array length is sufficient first:
<uscript>
if (X.Length <= 3)
  X.Length = 4;

X[3].Y[5] = 23;
</uscript>
The inner array access is a write operation, so that array is resized as usual. This type of array is sometimes called a "jagged array", because the inner arrays usually have different lengths.

==Workaround 2: Manual index arithmetics==
Another way to store and access data as if it was arranged in multiple dimensions are index arithmetics on a one-dimensional array. Whether you use static or dynamic arrays doesn't matter here, as both use the same element access syntax.

To calculate the total size of the array, simply multiply the sizes of all dimensions. If you want a three-dimensional array with dimensions 5, 2 and 3, you need to declare an array of length <code>5 * 2 * 3 = 30</code>. To access specific elements, you might want to use a macro or function that performs the necessary calculations:
<uscript>
const SIZE1 = 5;
const SIZE2 = 2;
const SIZE3 = 3;

function int CalcIndex(int index1, int index2, int index3)
{
  return (index1 * SIZE1 + index2) * SIZE2 + index3;
}
</uscript>

{{navbox unrealscript}}