<RetVar> = Der Rückgabewert dieses Befehls.
<Value> = Der Wert, dessen Stelle du bestimmen möchtest.
<Var/Array> = Das Array, von dem du die Stelle haben möchtest.
<Var/Number> = Erlaubt die Startposition im Array festzulegen, von der aus der gegebene Wert <Value> gesucht wird.
Gibt die Position des Elements <Value> in einem gewählten array <Var/Array> zurück.
Diese Position kann um den festgelegten Wert <Var/Number> +1 verschoben werden. Dies ist nötig, wenn der gleiche Wert im Array an mehreren Stellen vorhanden ist.
Beispiel
$value = 5
$index = get index of $value in array $this.array offset = -1 + 1
remove element from array $this.array at index $index
Das obige Beispiel würde die Stelle des gewählten Wertes finden und der Rückgabewert des Befehls könnte dann genutzt werden, um festzulegen, welche Stelle aus dem gewählten Array entfernt werden soll
Die -1 wird in diesem Beispiel genutzt, um von der ersten Stelle des Arrays (0 = -1 + 1) suchen zu können.
Wenn der 'get index'-Befehl den benötigten Wert im gewählten Array nicht finden kann, wird er -1 zurückgeben.
Beispiel 2
$array = create new array, arguments=1, 2, 1, 3, 1
$index1 = get index of 1 in array $array offset=-1 +1
(* $index1 == 0, da $array[0] == 1 und offset == 0 (-1 + 1 = 0) )
$index2 = get index of 1 in array $array offset=$index1 +1
(* $index2 == 2, da $array[2] == 1 und offset == 1 ($index1 + 1 = 1) )
$index3 = get index of 1 in array $array offset=$index2 +1
(* $index3 == 4, da $array[4] == 1 und offset == 3 ($index2 + 1 = 3) )
Verwandte Befehle:
remove element from array <Var/Array> at index <Var/Number>