ForEach : Next

ForEach Liste() oder Map()
  ...
Next [Liste() oder Map()]

ForEach durchläuft alle Elemente der angegebenen verknüpften 'Liste' oder 'Map', beginnend beim ersten Element bis zum letzten Element. Ist die Liste oder die Map leer, wird die ForEach : Next Schleife umgehend abgebrochen. Für eine Liste aller Befehle zur Verwaltung von verknüpften Listen siehe die Linked List Bibliothek. Alle Befehle zur Verwaltung von Maps finden Sie in der Map Bibliothek.

Bei der Verwendung mit verknüpften Listen ist es möglich, während der Schleife Elemente zu löschen oder hinzuzufügen. Ebenso darf mit ChangeCurrentElement() auch das aktuelle Element geändert werden. Nach einer der genannten Änderungen wird der nächste Schleifendurchlauf mit dem auf das aktuelle Element folgenden Element fortgesetzt.

Bei Verwendung im Zusammenhang mit einer Map, geben Sie bitte keinen Schlüssel an (siehe Beispiel unten).

Mit dem Break Befehl kann die ForEach : Next Schleife (vorzeitig) verlassen werden, mit dem Continue Befehl kann das Ende des aktuellen Schleifendurchlaufs übersprungen werden.

Beispiel: Verknüpfte Liste

  NewList Number()
  
  AddElement(Number())
  Number() = 10
    
  AddElement(Number())
  Number() = 20
    
  AddElement(Number())
  Number() = 30
    
  ForEach Number()
    Debug Number() ; wird 10, 20 und 30 ausgeben
  Next

Beispiel: Map

  NewMap Country.s()

  Country("US") = "United States"
  Country("FR") = "France"
  Country("GE") = "Germany"

  ForEach Country()
    Debug Country()
   ;Debug Country("FR") ; So nicht: bitte keinen Schlüssel angeben, da dies manchmal zu einer Endlosschleife führen kann
  Next