varname	Name der Variable, die den jeweiligen Schleifenwert zugewiesen bekommt.
expression	Ein belibieger Ausdruck, der als Basis für varname verwendet wird.

Beschreibung:

Das Kommando #FOREACH ist gedacht, um Maps iterativ abarbeiten zu können, ohne zuvor mittels m$keys() eine Schlüsselliste zu erzeugen. Als nicht unbedingt nötige Zusatzeigenschaft können auch Listen iterativ bearbeitet werden.

Zuerst wird der Ausdruck expression ausgewertet. Abhängigig vom Typ des Ergebnisses wird eine Schleife initialisiert:

MAP:
Die Schleife wird für jedes Element der Map genau einmal durchlaufen. Der Variable varname wird der Schlüssel des jeweiligen Map-Elementes zugewiesen. Aus Optimierungsgründen sollte, falls möglich, eine Referenz mittels copyRef(map) übergeben werden, da sonst eine Kopie der Map angelegt wird.
Sollte die Map leer sein, dann wird die Schleife nicht durchlaufen. Das Hinzufügen oder Entfernen von Map-Elementen sowie das Ändern von Daten ist möglich. Wird jedoch die Map neu organisiert, z.B. durch Aufruf von m$pack() oder m$purge(), dann wird die Ausführung der Schleife mit der nächsten geplanten Iteration beendet.
LIST:
Die Schleife wird für jedes Element der Liste genau einmal durchlaufen. Der Variable varname wird der Wert des jeweiligen Listenelementes zugewiesen. Sollte dieser Wert eine Liste oder eine Map sein, dann wird eine Referenz (siehe copyRef()) auf diesen Wert erstellt.
Aus Optimierungsgründen sollte, falls möglich, eine Referenz mittels copyRef(list) übergeben werden, da sonst eine Kopie der Map angelegt wird. Sollte die Liste leer sein, dann wird die Schleife nicht durchlaufen.
NONE:
Die Schleife wird nicht durchlaufen. Das Programm hinter dem korrespondierenden #ENDFOREACH fortgesetzt.
sonst: Die Schleife wird für jedes gesetzte Bit des Wertes genau einmal durchlaufen. Zeichenketten werden dabei als Bitfeld interpretiert. Der Variable varname wird der Index des jeweiligen Bits zugewiesen.

Jede FOREACH-Schleife muss mit dem Kommando #ENDFOREACH abgeschlossen werden. Mit dem Kommando #CONTINUE kann die nächste Iteration vorzeitig gestartet werden. Mit dem Kommando #BREAK wird die Schleife vorzeitig beendet.

Siehe auch:
#ENDFOREACH #BREAK #CONTINUE #FOR

Weitere ähnliche Kommandos:

Schleifen
Kommando	Kurzinfo
#BREAK	Eine oder mehrere Schleifen vorzeitig beenden.
#CONTINUE	Die nächste Iteration einer Schleife vorzeitig neu beginnen.
#ENDEACH	Ende einer #FOREACH-Schleife.
#ENDF	Ende einer #FOR-Schleife.
#ENDFOR	Ende einer #FOR-Schleife.
#ENDFOREACH	Ende einer #FOREACH-Schleife.
#ENDL	Ende einer #LOOP-Schleife.
#ENDLOOP	Ende einer #LOOP-Schleife.
#ENDR	Ende einer #REPEAT-Schleife.
#ENDREPEAT	Ende einer #REPEAT-Schleife.
#ENDW	Ende einer #WHILE-Schleife.
#ENDWHILE	Ende einer #WHILE-Schleife.
#FOR	—
#FOREACH	Schleife für jedes Element einer Liste oder Map.
#LOOP	Beginn einer Endlos-Schleife.
#REPEAT	—
#RESTART	—
#WHILE	—