Extension:Loops/cs

Rozšíření Loops poskytuje pro funkce pro zpracování dat ve smyčkách.

Aktuálně se vyvíjí verze 1.0.0, která již bude obsahovat a  pro vyhledání stránek s velkým počtem smyček a, pro zabránění regresím. Níže uvedená dokumentace se vztahuje k poslední stabilní verzi v0.5.2.

O to aby tato verze fungovala se v současné době stará MGChecker.

provádí smyčku (tj. opakovaně analyzuje daný příkaz wiki markup block), dokud se označení podmínky vyhodnotí jako bez mezer.


 * Příklady:

Tento wiki kód:

bude interpretován takto:


 * 0
 * 1
 * 2
 * 3
 * 4

lze využít v šabloně rovněž jako náhradu za pole indexované pořadovým číslem. Pokud šablona "Template:Loops Test" bude obsahovat:

následující wiki kód aplikované šablony:

bude vracet následující:


 * nula
 * jedna
 * dvě
 * tři
 * čtyři

Je důležité si uvědomit, že všechny bílé znaky, včetně nových řádků, tabulátorů a mezer, jsou ze začátku a konce všech argumentů u těchto parsovacích funkcí během zpracování odstraněny. Není-li tohle chování potlačeno, budou oříznuty všechny bílé znaky a to včetně mezery zapsané sekvencí. K potlačení se využívá značka (jak můžete vidět na uvedených příkladech).

pracuje naprosto stejně jako, jen s tím rozdílem, že pokud má být výsledkem zpracování text, tak se zobrazí alespoň jednou. A to předtím, než se vyhodnotí podmínka.

opakovaně zpracovává a zobrazuje &lt;wiki markup>, dokud počet cyklů nedosáhne hodnoty &lt;number of loops to be performed>. &lt;Starting value> je vložena do proměnné &lt;variable name>, se kterou lze dále pracovat přes parsovací funkci  (pokud máte nainstalováno rozšíření ). Po každém průběhu je hodnota proměnné inkrementálně navýšena, je-li hodnota &lt;number of loops to be performed> kladná, nebo snížena je-li hodnota &lt;number of loops to be performed> záporná.

Následující kód:
 * Příklady :

bude vracet:


 * Hodnota je 4 a zbývá 3 cyklů
 * Hodnota je 5 a zbývá 2 cyklů
 * Hodnota je 6 a zbývá 1 cyklů
 * Hodnota je 7 a zbývá 0 cyklů

(experimentální)
se používá v šablonách.

Vezme argumenty, které jsou předány šabloně, a vloží je do proměnných přístupných pomocí funkce analyzátoru  rozšíření.

Tato funkce prochází každý argument, jehož název začíná &lt;prefix>.

S každou iterací vloží název argumentu mínus &lt;prefix> into &lt;key>, jako by volal.

Potom vezme hodnotu argumentu a vloží ji do &lt;value> podobným způsobem.

Blokový příkaz se pak rozbalí.

Blokový příkaz může obsahovat  a   pro přístup k uloženým argumentům. Pokud šablona "Template:Loops Test" bude obsahovat
 * Příklad

bude následující wiki kód aplikované šablony

produces


 * 1 = val1
 * 5 = val5
 * ument = value

(experimentální)
funguje podobně jako  se dvěma hlavními rozdíly: Nepotřebuje předponový argument a funguje pouze s číslovanými argumenty, ať už jsou explicitně očíslovány,

nebo implicitně očíslované.

Kombinace těchto metod v jediném volání šablony může způsobit přepsání hodnot, takže buďte opatrní.

Pokud bude šablona "Template:Loops Test" obsahovat:
 * Příklady

pak její následující aplikace:

bude vracet pouze hodnoty pozičních parametrů a parametrů identifikovaných číslem:


 * 1 = Apricot
 * 2 = Caramel slice
 * 5 = Eclair

Konfigurace
Tyto konfigurační proměnné musí být nastaveny v souboru  po zahrnutí tohoto rozšíření.


 * ( v nadcházející verzi 1.0.0)
 * Tento parametr nastavuje maximální počet smyček, které může stránka provést (výchozí ). Nastavením na   umožníte cyklům běžet v rámci limitů prostředí phps. Tento parametr neovlivňuje funkce analyzátoru   ani.


 * Konfigurační proměnná (pole) pro definování, které funkce Loops by měly být povoleny. Ve výchozím nastavení jsou všechny funkce povoleny, pokud je nainstalováno i rozšíření . Pokud rozšíření Variables není nainstalováno,,   a   budou deaktivovány, protože bez jeho instalace nefungují. Chcete-li povolit pouze funkce   a  , můžete použít:
 * Konfigurační proměnná (pole) pro definování, které funkce Loops by měly být povoleny. Ve výchozím nastavení jsou všechny funkce povoleny, pokud je nainstalováno i rozšíření . Pokud rozšíření Variables není nainstalováno,,   a   budou deaktivovány, protože bez jeho instalace nefungují. Chcete-li povolit pouze funkce   a  , můžete použít:

Související stránky

 * - Jiné rozšíření umožňující použití smyčky
 * Module:Loops