Bezeichnung
ForEachI -- durchläuft alle Ganzzahlen-Indizes einer Tabelle (V5.0)
Übersicht
[v] = ForEachI(table, func[, userdata])
Beschreibung
Dieser Befehl kann verwendet werden, um alle Ganzzahlen-Indizes der Tabelle zu durchlaufen, die im Argument table angegeben ist. Für jedes Tabellenelement mit einem ganzzahligen Index wird die Benutzerfunktion aufgerufen, die im Argument func angegeben ist. Die Benutzerfunktion wird zwei Argumente erhalten: Das erste Argument wird den Index des Tabellenelements enthalten, während das zweite Argument den Wert von diesem Index enthält. Wenn die Benutzerfunktion einen Wert zurückgibt, wird die Schleife unterbrochen und dieser Wert wird als Ergebnis von ForEach() zurückgegeben.

Bitte beachten Sie, dass dieser Befehl nur die Ganzzahlen-Indizes durchläuft. Wenn Sie die gesamte Tabelle durchlaufen möchten, verwenden Sie stattdessen dafür den Befehl ForEach(). Siehe ForEach für Details.

Beginnend mit Hollywood 6.1 akzeptiert dieser Befehl das optionale Argument userdata. Der Wert, den Sie hier angeben, wird als drittes Argument an Ihre Callback-Funktion weitergeleitet. Der Wert kann von beliebiger Art sein.

Eingaben
table
Tabelle, die durchlaufen werden soll
func
Benutzerfunktion, welche für jedes Tabellenelement aufgerufen wird
userdata
optional: Benutzerdaten, die an die Callback-Funktion weitergegeben wird (V6.1)
Rückgabewerte
v
optional: Rückgabewert, wenn der Durchlauf von einer Benutzerfunktion unterbrochen wird (siehe oben).
Beispiel
t = {1, 2, 3, 4, Test$="Hello", Value=9.2}
ForEachI(t, DebugPrint)
Der obige Code bildet den Inhalt der Tabelle in t ab. Das bedeutet, dass die Indizes Test$ und Value nicht beachtet werden.

Navigation zeigen