For (SP-Tag): Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
K (hat „Sp:for (SP-Tag)“ nach „For (SP-Tag)“ verschoben) |
K (Hob den Schutz von „For (SP-Tag)“ auf) |
||
(10 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt) | |||
Zeile 4: | Zeile 4: | ||
==Syntax== | ==Syntax== | ||
<source lang="xml"> | <source lang="xml"> | ||
− | <sp: | + | <sp:for index="counter" from="0" to="10"> |
− | </source> | + | ... |
+ | </sp:for> | ||
+ | </source> | ||
==Beschreibung== | ==Beschreibung== | ||
− | + | Mit Hilfe des For-Tag kann eine Schleife definiert werden. <code>from</code> gibt den Startwert des Indexes an. Bei jedem Schleifendurchlauf wird <code>index</code> um den Wert <code>step</code> erhöht (bzw. vermindert, wenn <code>step</code> negativ ist). Die Schleife wird solange durchlaufen, bis <code>to</code> den Wert <code>index</code> erreicht hat. Alternativ zu <code>to</code> kann auch <code>condition</code> angegeben werden. In diesem Fall wird die Schleife solange durchlaufen, bis <code>condition</code> <code>false</code> ergibt. | |
==Attribute== | ==Attribute== | ||
− | {| class="prettytable" | + | {| class="prettytable sortable" |
|- class="hintergrundfarbe1" | |- class="hintergrundfarbe1" | ||
! Name || Type || Required || Default || ab IES Version | ! Name || Type || Required || Default || ab IES Version | ||
|- | |- | ||
− | | <code> | + | | <code>index</code> |
− | | [[ | + | | [[Variable]] |
| Ja | | Ja | ||
| None | | None | ||
| 1 | | 1 | ||
|- | |- | ||
− | | <code> | + | | <code>from</code> |
− | | [[ | + | | [[Expression]] |
− | | | + | | Ja |
+ | | None | ||
+ | | 1 | ||
+ | |- | ||
+ | | <code>to</code> | ||
+ | | [[Expression]] | ||
+ | | Ja oder <code>condition</code> | ||
+ | | None | ||
+ | | 1 | ||
+ | |- | ||
+ | | <code>condition</code> | ||
+ | | [[Condition]] | ||
+ | | Ja oder <code>to</code> | ||
| None | | None | ||
| 1 | | 1 | ||
|- | |- | ||
− | | <code> | + | | <code>step</code> |
| [[Expression]] | | [[Expression]] | ||
| Nein | | Nein | ||
− | | | + | | 1 |
| 1 | | 1 | ||
|- | |- | ||
− | | <code> | + | | <code>locale</code> |
| [[Locale]] | | [[Locale]] | ||
| Nein | | Nein | ||
Zeile 40: | Zeile 54: | ||
|} | |} | ||
− | ;<code> | + | ;<code>index</code> |
− | : | + | :Name der Variable, die den aktuellen Zählerstand enthält |
+ | |||
+ | ;<code>from</code> | ||
+ | :Startwert des Zählers | ||
+ | |||
+ | ;<code>to</code> | ||
+ | :Endwert des Zählers | ||
+ | |||
+ | ;<code>condition</code> | ||
+ | :Die For-Schleife wird solange durchlaufen, bis die Bedingung <code>false</code> ergibt | ||
+ | |||
+ | ;<code>step</code> | ||
+ | :Schrittweite, in der gezählt werden soll. <code>step</code> kann für einen Rückwärtszähler negativ sein | ||
− | ;<code> | + | ;<code>locale</code> |
− | : | + | :Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachigen Variablen |
==Beispiele== | ==Beispiele== | ||
− | === | + | ===Einfache from/to Schleife=== |
Template Quelltext | Template Quelltext | ||
<source lang="xml"> | <source lang="xml"> | ||
− | + | <sp:for index="i" from="1" to="3"> | |
+ | index: <sp:print name="i"/><br> | ||
+ | </sp:for> | ||
</source> | </source> | ||
Ausgabe | Ausgabe | ||
<source lang="text"> | <source lang="text"> | ||
− | + | index: 1 | |
+ | index: 2 | ||
+ | index: 3 | ||
</source> | </source> | ||
− | === | + | ===Schleife mit Bedingung=== |
Template Quelltext | Template Quelltext | ||
<source lang="xml"> | <source lang="xml"> | ||
− | + | <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> | ||
</source> | </source> | ||
Ausgabe | Ausgabe | ||
<source lang="text"> | <source lang="text"> | ||
− | + | index: 10 | |
+ | index: 9 | ||
+ | index: 8 | ||
+ | index: 7 | ||
+ | index: 6 | ||
+ | index: 5 | ||
</source> | </source> | ||
<noinclude> | <noinclude> | ||
[[Category:SP-Tags]] | [[Category:SP-Tags]] | ||
− | |||
− | |||
[[Category:Qualität_des_Codes_prüfen]] | [[Category:Qualität_des_Codes_prüfen]] | ||
+ | [[Category:Beispiel_überarbeiten_testen]] | ||
</noinclude> | </noinclude> |
Aktuelle Version vom 24. Februar 2010, 12:30 Uhr
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