arrayprint

Tato funkce vytiskne hodnoty pole v přizpůsobitelném formátu.

Syntaxe:

{{#arrayprint:key|delimiter|pattern|subject|options}}

Poznámky:

• subject přijímá wiki odkazy, šablony a funkce parseru.
• V rámci subject nemusíte escapovat znaky |. V rámci celého konstruktu bude pattern prohledán a nahrazen aktuální (escaped) hodnotou pole každé smyčky. Nakonec bude celý řetězec analyzován a vložen do pole výsledků, které bude implodováno s delimiter jako separátorem.
• V případě, že pole, které má být vytištěno neexistuje, bude vrácen prázdný řetězec (zavedeno v 1.4 alpha, součást režimu kompatibility).
• Výchozí oddělovač je závislý na jazyce, pro angličtinu je to , (zavedeno ve verzi 2.0, součást režimu kompatibility).

Příklady:

{{#arrayprint:b}}

{{#arrayprint:b | }}

{{#arrayprint:b |<br/> }}

{{#arrayprint:b ||@ |@ |print=pretty }}

{{#arrayprint:b |<br/> |@@@@ |[[:Category:@@@@|@@@@]] }}

{{#arrayprint:b |<br/> |@@@@ |[[prop1::@@@@]] }}

{{#arrayprint:b |<br/> |@@@@ |length of @@@@:{{#len:@@@@}} }}

{{#arrayprint:b|<br/>|@@@@|{{template|prop2|@@@@}} }}

arrayindex

Tato funkce vytiskne hodnotu pole (identifikovaného key) na pozici index.

Syntaxe:

{{#arrayindex:key|index|default}}

Poznámky:

• Neplatný index (bez čísla, mimo rámec) bude mít za následek vytištění prázdného řetězce.
• Index je založen na 0, tj. index prvního prvku je 0.
• Záporné indexy vrátí prvek, který je daleko od konce (např. -1 by byl posledním prvkem pole).
• default bude vráceno v případě, že pole neexistuje, klíč v poli neexistuje nebo pokud je hodnota prázdný řetězec.

Příklady:

{{#arrayindex:a |2 }}

{{#arrayindex:b |-1 }}

{{#arrayindex:c |foo |bad value }}

arraysize

Tato funkce vrací velikost (počet prvků) pole.

Podívejte se na https://php.net/function.count V případě, že dané pole neexistuje, bude výstupem funkce místo čísla prázdný řetězec. To umožňuje zkontrolovat, zda pole existuje.

Syntaxe:

{{#arraysize:key}}

Příklady:

{{#arraysize:a}}

{{#if: {{#arraysize:a}} | ''pole existuje'' | ''pole není definováno'' }}

arraysearch

Tato funkce vrací index prvního výskytu value v poli (identifikováno key) počínaje pozicí identifikovanou parametrem index a v případě selhání vrátí prázdný řetězec. Když je zadáno yes a nebo no, rozšíří se tím nastavená hodnota na yes, pokud bude nalezena, v opačném případě na hodnotu no. Podívejte se na https://php.net/function.array-search

Syntaxe:

{{#arraysearch:key|value|index|yes|no}}

Příklady:

{{#arraysearch:b|white}}
{{#arraysearch:b|red}}
použít offset
{{#arraysearch:b|red|0}}
{{#arraysearch:b|red|2}}
použijte preg shodu s regulárním výrazem
{{#arraysearch:b|/low/}}
{{#arraysearch:b|/LOW/i}} - nerozlišuje malá a velká písmena
{{#arraysearch:b|low}}
použijte ano ne pro možnost tisku
{{#arraysearch:b|white|0|yes|no}}
{{#arraysearch:b|yellow|0|yes|no}}

arraysearcharray

Tato funkce prohledá pole (identifikované key) a vytvoří nové pole (identifikované new_key) z vyhledávání se všemi výsledky. Kritériem vyhledávání value může být řetězec nebo regulární výraz. Pokud je zadáno index, vyhledávání začne tam, limit může definovat maximální výsledky vyhledávání. Parametr identifikovaný transform lze použít, pokud je value regulární výraz. Dokáže transformovat výsledek odpovídajících položek do pole new_key, jako by to udělal PHP preg_replace.

Syntaxe:

{{#arraysearcharray:new_key|key|value|index|limit|transform}}

Poznámky:

• Pokud je value řetězec, pole new_key bude obsahovat pouze položky přesně tohoto řetězce.
• Záporné hodnoty index jako -n lze použít pouze k vyhledávání posledních n záznamů.
• Pokud je na wiki k dispozici Extension:Regex Fun , lze v regulárním výrazu použít modifikátor e Regex Fun. To nemá nic společného s modifikátorem e PHP (což by bylo porušením zabezpečení). S aktivním modifikátorem e bude řetězec transform analyzován po vložení zpětných odkazů, poté nahradí skutečnou shodu.

Příklady:

{{#arraysearcharray:x |a |/^A\s.+/ }}

{{#arraysearcharray:y |a |/^.*?(\d+)$/ |0 |-1 | $1 }}

{{#arraysearcharray:y |y |/^.*?\d+$/e |0 |-1 | {{#len:$0}} }}

{{#arraysearcharray:a|a|/\S+/}}

arrayslice

Tato funkce extrahuje dílčí pole z pole (identifikovaného key) do nového pole (označeného new_key).

Podívejte se na https://php.net/function.array-slice

Syntaxe:

{{#arrayslice:new_key|key|offset|length}}

Poznámky:

• Offset označuje počáteční bod řezu, může to být nezáporné číslo nebo záporné číslo pro zpětný index (např. poslední prvek offsetu pole je -1). Posun se liší od indexu (což musí být nezáporné číslo)
• Délka udává, kolik prvků se má extrahovat. Pokud je vynechán, bude mít sekvence vše od offsetu až po konec pole.
• Pokud offset není menší než velikost pole, bude vráceno prázdné pole, pokud offset není větší než záporná velikost pole, bude vráceno nové pole se všemi prvky.

Příklady:

{{#arrayslice:x|b|1|2}}

{{#arrayslice:x|b|-2|2}}

arrayunique

Tato funkce převede pole (identifikované 'klíčem') na množinu (žádné duplicitní členy, žádný prázdný prvek).

Podívejte se na https://php.net/function.array-unique

Syntaxe:

{{#arrayunique:key}}

Příklad:

{{#arrayunique:b}}

arrayreset

Tato funkce zruší nastavení některých nebo všech definovaných polí.

Syntaxe:

{{#arrayreset:}} <!-- zruší nastavení VŠECH polí -->
{{#arrayreset:key1 |key2 |... |key-n }}

Poznámky:

• Když na ně použijete arraysize, vrátí se prázdný řetězec místo 0, takže jsou skutečně nenastavené, nikoli prázdné. K jednoduchému vyprázdnění pole lze použít {{#arraydefine:key}}.
• Před verzí 1.4 se alfa , používá k oddělení několika polí, která by měla být deaktivována.

arraysort

Tato funkce seřadí pole v následujícím pořadí.

• none - žádné řazení (výchozí)
• desc - v sestupném pořadí (viz https://php.net/function.sort)
• asce/asc - vzestupně (viz https://php.net/function.rsort)
• random - v náhodném pořadí (viz https://php.net/function.array-rand)
• reverse - v opačném pořadí (viz https://php.net/function.array-reverse)

Syntaxe:

{{#arraysort:key|order}}

Poznámka:

• Každý prvek pole je považován za řetězec, což znamená, že čísla nemusí být uspořádána podle očekávání.

Příklady:

{{#arraysort:x|desc}}

{{#arraysort:x|random}}

{{#arraysort:x|reverse}}

arraymerge

Tato funkce sloučí hodnoty dvou nebo více polí do nového pole (označeného new_key).

Podívejte se na https://php.net/function.array-merge

Syntaxe:

{{#arraymerge:new_key |key1 |key2 |... |key-n }}

Příklady:

{{#arraymerge:x |a |b }}

{{#arraymerge:x |b }}

arrayunion

Tato funkce sloučí hodnoty dvou nebo více polí do nového pole (označeného new_key) bez duplicitních hodnot.

Syntaxe:

{{#arrayunion:new_key |key1 |key2 |... |key-n }}

Poznámky:

• Toto je operátor množiny, tj. vrácené pole je množina bez duplicitních hodnot.
• To se rovná arraymerge a poté arrayunique.

Příklad:

{{#arrayunion:x |a |b |c }}

arraydiff

Tato funkce počítá (teoretický rozdíl) dvou nebo více polí. Pole výsledků je označeno new_key. Vrácené pole je sada, která obsahuje prvky prvního daného pole (identifikovaného key1), které nejsou definovány v žádném jiném poli. Podívejte se na https://php.net/function.array-diff

Syntaxe:

{{#arraydiff:new_key |key1 |key2 |... |key-n }}

Poznámka:

• Toto je operátor množiny, tj. vrácené pole je množina bez duplicitních hodnot.
• Tuto funkci lze použít k testování vztahu podtřídy.

Příklady:

{{#arraydiff:x |b |a }}

{{#arraydiff:x |a |b }}

{{#arraydiff:x |a |b |c }}

arrayintersect

Tato funkce počítá teoretický průnik množin dvou nebo více daných polí. Pole výsledků je označeno new_key. Podívejte se na https://php.net/function.array-intersect

Syntaxe:

{{#arrayintersect:new_key |key1 |key2 |... |key-n }}

Poznámka:

• Toto je operátor množiny, tj. vrácené pole je množina bez duplicitních hodnot.

Příklad:

{{#arrayintersect:x |a |b |c }}

Použití arrayprint

<!-- definování pole -->
{{#arraydefine:colors|Red,Blue,Yellow}}

{{#arrayprint:colors||@@@@|<nowiki/>
* délka @@@@: {{#len:@@@@}}
}}

Níže je očekávaný výstup:

Další příklady lze nalézt na bývalé Wiki Tetherless World.

Použití rozšíření Loops

Pro složitější úlohy je možné procházet polem pomocí rozšíření Loops .

{{ #arraydefine: colors | red;#FF0000, green;#00FF00, blue;#0000FF }}
{{
  #loop: i
  | 0                       <!-- počáteční hodnota smyček pro {{ #var:i }} -->
  | {{ #arraysize:colors }} <!-- počet smyček -->
  | <nowiki/>
* {{
    #arraydefine: val | {{ #arrayindex:colors | {{ #var:i }} }} | ;
  }}
  <span style="color:{{ #arrayindex: val | 1 }}">
  {{ #arrayindex: val | 0 }}
  </span>
}}

Výsledkem by bylo něco jako:

• red
• green
• blue

Použití Extension:Semantic Result Formats

Semantic Result Formats (SRF) zavádí formát Array ve verzi 1.6.1. Lze jej použít k dotazování na data, která budou automaticky uložena v poli Extension:Arrays. Toto je preferované řešení zabývající se sémantickými daty v polích. Podrobnosti najdete na semantic-mediawiki.org.

Příklad:

{{#ask: [[Category:Color]][[:+]] |format=array |name=colors}}
{{#arrayprint: colors}}

Použití standardního dotazu

Pokud nemůžete použít řešení SRF výše, Arrays také umožňuje naplnit pole pomocí výsledku dotazu SMW ve formátu list:

Příklad A: Chcete-li vytvořit seznam instancí třídy Color

{{#arraydefine:colors|{{#ask:[[Category:Color]][[:+]] |sep =, |limit=1000}} }}

Příklad B: Chcete-li vytvořit jedinečný seznam hodnot vlastnosti has color

{{#arraydefine:colors|{{#ask:[[has color::+]][[:+]] |?color= |mainlabel=- |sep =, |limit=1000}} |,|unique}}

Příklad C: Zacházet s 2D polem generovaným dotazem SWM (např. vlastnost typu záznamu)

given a 2D array "red;#da2021, yellow;#fcff00, green;#00ff00"

1. vytvořte řádek <code>colors</code>
{{#arraydefine:colors|red;#da2021, yellow;#fcff00, green;#00ff00}}

2. rozdělte první prvek '<code>colors</code>' do jiného pole <code>colors0</code>
{{#arraydefine:color0|{{#arrayindex:colors|0}}|;}}

Poznámky:

• parametry sémantického dotazu
  • Volba limit=1000 se používá k vyčerpání všech vrácených výsledků sémantického dotazu
  • Volba sep=, se používá k nastavení oddělovače pro záznamy výsledků
  • mainlabel=- možnost oříznout sloupec stránky