An array represents an indexed collection of elements of the same type (called the base type). You can work with any element directly via its index. An index numeration begins with a zero. Arrays are supported in San Andreas, LCS and VCS.

General Syntax

San Andreas: <array name>(<index var name>,<size><type>)

$index = 0
$array($index,10i) = 1

<array name>: local or global variable <index var name>: any variable containing an index of the element to read or write <size>: any value greater than 0 <type>: one of characters i f s v:

Liberty City Stories, Vice City Stories: <array name>(<index var name>,<size>)

$index = 0
$array($index,10) = 1

Array Declaration

Arrays can be declared using the VAR..END construct: var <array name>: array <size> of <type> end

var
    $FloatArray: array 10 of Float
end

Accessing array elements after declaration

After declaring an array you can work access its elements using square brackets:

var
    $FloatArray: array 10 of Float
end
$index = 1
$FloatArray[$index] += 100.0

Using constant indexes

You can use positive integer numbers and zero to access a particular array element:

var
    $FloatArray: array 10 of Float
end
$FloatArray[1] += 100.0

Elements of an array containing string literals can be accessed with string variables:

// initializing first three elements of the $strings array
s$strings[0] = 'str1'
s$strings[1] = 'str2'
s$strings[2] = 'str3'

An array can be declared as a collection of class instances:

var
  $players: array 2 of Player
end
$players[0].Build