Bezeichnung
ForEach -- durchläuft alle Elemente einer Tabelle (V5.0)
Übersicht
[v] = ForEach(table, func[, userdata])
Beschreibung
Dieser Befehl kann verwendet werden, um alle Elemente der Tabelle zu durchlaufen, die im ersten Argument table angegeben ist. Für jedes Tabellenelement ruft dieser Befehl die Benutzerfunktion auf, welche in func angegeben ist. Die Benutzerfunktion erhält zwei Argumente: Das erste Argument wird den Index der Tabellenelemente enthalten, während das zweite Argument den Wert in 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 die gesamte Tabelle durchläuft. Wenn Sie nur die Ganzzahlen-Indizes durchlaufen möchten, verwenden Sie stattdessen den Befehl ForEachI(). Siehe ForEachI 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}
ForEach(t, DebugPrint)
Der obige Code bildet den Inhalt der Tabelle in t ab, bei Verwendung von ForEach().
Navigation zeigen