For (SP-Tag)

Name

<sp:for> - For-Schleife

Syntax

<sp:for index="counter" from="0" to="10">
   ...
</sp:for>

Beschreibung

Mit Hilfe des For-Tag kann eine Schleife definiert werden. from gibt den Startwert des Indexes an. Bei jedem Schleifendurchlauf wird index um den Wert step erhöht (bzw vermindert, wenn step negativ ist). Die Schleife wird solange durchlaufen bis to den Wert index erreicht hat. Alternativ zu to kann auch condition angegeben werden. In diesem Fall wird die Schleife solange durchlaufen, bis condition false ergibt.

Attribute

Name	Type	Required	Default	ab IES Version
index	Variable	Ja	None	1
from	Expression	Ja	None	1
to	Expression	Ja oder condition	None	1
condition	Condition	Ja oder to	None	1
step	Expression	Nein	1	1
locale	Locale	Nein	None	1

index

Name der Variable, die den aktuellen Zählerstand enthält.

from

Startwert des Zählers.

to

Endwert des Zählers.

condition

Die For-Schleife wird solange durchlaufen, bis die Bedingung false ergibt.

step

Schrittweite, in der gezählt werden soll. step kann für einen Rückwärtszähler negativ sein.

locale

Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachigen Variablen.

Beispiele

Einfache from/to Schleife

Template Quelltext

<sp:for index="i" from="1" to="3">
  index: <sp:print name="i"/><br>
</sp:for>

Ausgabe

index: 1
index: 2
index: 3

Schleife mit Bedingung

Template Quelltext

<sp:set name="start" value="10"/>
<sp:set name="end" value="4"/>
<sp:set name="step" value="-1"/>
<sp:for index="i" from="${start}" condition="${i} >= (${end} + 1)" step="${step}">
  index: <sp:print name="i"/><br>
</sp:for>

Ausgabe

index: 10
index: 9
index: 8
index: 7
index: 6
index: 5