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í ). Setting it to   lets the loops run within the limits of phps environment. This parameter affects neither the   nor   parser functions.


 * Configuration variable (array) to define which Loops functions should be enabled. By default, all functions are enabled if the extension is installed as well. If the Variables extension is not installed, ,   and   will be disabled since they do not work without it being installed. To enable the   and   functions only, one can use:
 * Configuration variable (array) to define which Loops functions should be enabled. By default, all functions are enabled if the extension is installed as well. If the Variables extension is not installed, ,   and   will be disabled since they do not work without it being installed. To enable the   and   functions only, one can use:

Viz též

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