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.

It takes arguments that are passed to the template and puts them in variables accessible by extension's   parser function.

This function iterates through each argument whose name begins with &lt;prefix>.

With each iteration it puts the argument name minus &lt;prefix> into &lt;key> as if calling.

It then takes the value of the argument and puts it into &lt;value> in a similar method.

The block statement is then expanded.

The block statement may contain  and   to access the stored arguments. 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í)
performs similarly to  with two major differences: It doesn't take a prefix argument, and it only works on numbered arguments whether they're explicitly numbered,

or implicitly numbered.

Mixing these methods in a single template call may cause values to get overwritten, so be careful.

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
These configuration variables have to be set in the  file after the inclusion of this extension.


 * ( in the forthcoming 1.0.0 release )
 * This parameter sets the maximum number of loops a page is allowed to perform (default ). 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