Vidi kôd stranice Pomoć:Funkcije parsera

'''Funkcije parsera''' svojevrsne su magične riječi koje primaju parametre i vraćaju rezultat nakon obrade.

{{glavni|mw:Help:Magic words#Parser functions|mw:Help:Extension:ParserFunctions}}

== Uvjetne parserske funkcije ==
=== expr ===
{| class="wikitable" style="float:right; width:30%; margin-right:1em"
|-
! Tip
! [[Operator (programiranje)|Operatori]]
|-
| Grupiranje (zagrade)
| style="word-spacing: 0.5em; font-weight: bold;" | <code>( )</code>
|-
| Brojevi
| <code>'''1234.5'''</code> &nbsp; <code>'''e'''</code>&nbsp;(2.718) &nbsp; <code>'''pi'''</code>&nbsp;(3.142)
|-
|
| Binarni operator <code>'''e'''</code> &nbsp; unarni <code>'''+'''</code>,<code>'''-'''</code>
|-
| Unarni
| style="word-spacing: 0.5em; font-weight: bold;" | <code>not ceil trunc floor abs exp ln sin cos tan acos asin atan</code>
|-
|rowspan="3" | Binarni
| style="word-spacing: 0.5em; font-weight: bold;" | <code>^</code>
|-
| style="word-spacing: 0.5em; font-weight: bold;" | <code>* / div mod</code>
|-
| style="word-spacing: 0.5em; font-weight: bold;" | <code>+ -</code>
|-
| Zaokruživanje
| style="word-spacing: 0.5em; font-weight: bold;" | <code>round</code>
|-
|rowspan="3" | [[Booleova algebra]]
| style="word-spacing: 0.5em; font-weight: bold;" | <code>= != <> > < >= <=</code>
|-
| style="word-spacing: 0.5em; font-weight: bold;" | <code>and</code>
|-
| style="word-spacing: 0.5em; font-weight: bold;" | <code>or</code>
|}

Parserska funkcija '''#expr''' služi za izračunavanje matematičkih ili [[Booleova algebra|Booleovih izraza]]. Funkcija podržava [[Logaritam|logaritamske]] i [[Trigonometrija|trigonometrijske]] izračune, znanstvenu notaciju, matematičke funkcije poput floor() ili trunc() i poštuje redoslijed matematičkih operacija.

Sintaksa: <code><nowiki>{{#expr:</nowiki> ''matematički izraz'' }}</code>

* <code><nowiki>{{#expr:floor1.5e1}}</nowiki></code> => {{#expr:floor1.5e1}}
* <code><nowiki>{{#expr:(not0or1)and0}}</nowiki></code> => {{#expr:(not0or1)and0}}
* <code><nowiki>{{#expr:floor1.5^2}} </nowiki></code> => {{#expr:floor1.5^2}} 
* <code><nowiki>{{#expr:12/3*2}}</nowiki></code> => {{#expr:12/3*2}}
* <code><nowiki>{{#expr:111/3mod10}}</nowiki></code> => {{#expr:111/3mod10}}
* <code><nowiki>{{#expr:358mod10*2}}</nowiki></code> => {{#expr:358mod10*2}}
* <code><nowiki>{{#expr:1.234round2-1}}</nowiki></code> => {{#expr:1.234round2-1}}

=== if ===
Funkcija '''#if''' prima određenu vrijednost i vraća rezultat ovisno o tome je li vrijednost prazna ili ne.

Sintaksa: <code><nowiki>{{#if:</nowiki> testni izraz | rezultat ako izraz nije prazan | rezultat ako je izraz prazan ili sadrži samo bjeline }}</code>

* <code><nowiki>{{#if: abc | postoji | ne postoji}}</nowiki></code> => {{#if: abc | postoji | ne postoji}}
* <code><nowiki>{{#if:     | postoji | ne postoji}}</nowiki></code> => {{#if:     | postoji | ne postoji}}
Funkcija se najčešće upotrebljava za provjeru ima li parametar predloška asociranu vrijednost ili ne. Parametar nakon imena mora imati znak | kako bi funkcija radila očekivano. Primjerice, ako pozovemo predložak {{tlx|Primjer |2=ime=David}}, tada je: 
* <code><nowiki>{{#if: {{{ime|}}} | postoji | ne postoji }}</nowiki></code> => postoji
* <code><nowiki>{{#if: {{{ime|}}} | Bok {{{ime}}}! | Niste unijeli ime }}</nowiki></code> => Bok David! 
* <code><nowiki>{{#if: {{{prezime|}}} | postoji | ne postoji }}</nowiki></code> => ne postoji
* <code><nowiki>{{#if: {{{prezime}}} | postoji | ne postoji }}</nowiki></code> => postoji {{efn|Nedostaje znak <code>{{!}}</code>; ovo se shvaća kao doslovni unos "<nowiki>{{{prezime}}}</nowiki>"}}
Ponašanje parametara detaljnije je prikazano u tablici ispod:
{| class="wikitable" style="text-align: center;"
! colspan="2" |Parametar
! rowspan="2" |<nowiki>{{{1}}}</nowiki>
! rowspan="2" |<nowiki>{{{1|}}}</nowiki>
! colspan="2" |<nowiki>{{#if: <parametar> | da | ne }}</nowiki>
|-
!Opis
!Primjer, pozicijski
!<nowiki>{{{1}}}</nowiki>
!<nowiki>{{{1|}}}</nowiki>
|-
|Nije definiran
|<code><nowiki>{{primjer}}</nowiki></code>
|<nowiki>{{{1}}}</nowiki>
|
|style="background-color:#AFA" | da
|style="background-color:#FAA" | ne
|-
|Definiran, ali prazan ili ''null''
|<code><nowiki>{{primjer|}}, {{primjer|1=}}, {{primjer|param=}}</nowiki></code>
|
|
|style="background-color:#FAA" | ne
|style="background-color:#FAA" | ne
|-
|Definiran, nije prazan
|<code><nowiki>{{primjer|abc}}, {{primjer|1=abc}}, {{primjer|param=abc}}</nowiki></code>
|abc
|abc
|style="background-color:#AFA" | da
|style="background-color:#AFA" | da
|}

=== ifeq ===
Funkcija parsera '''#ifeq''' uspoređuje dvije ulazne vrijednosti i vraća rezultat ovisno o tome jesu li vrijednosti identične. Ako je potrebno raditi više usporedbi i definirati više od dva izlazna slučaja, preporučeno je upotrebljavati funkciju [[#switch]].

Sintaksa: <code><nowiki>{{#ifeq:</nowiki> prvi ulaz | drugi ulaz | rezultat ako su ulazi jednaki | rezultat ako ulazi nisu jednaki }}</code>

* <code><nowiki>{{#ifeq: abc | abc | jednako | nejednako }}</nowiki></code> => {{#ifeq: abc | abc | jednako | nejednako }}
* <code><nowiki>{{#ifeq: abc | def | jednako | nejednako }}</nowiki></code> => {{#ifeq: abc | def | jednako | nejednako }}
* <code><nowiki>{{#ifeq: Abc | abc | jednako | nejednako }}</nowiki></code> => {{#ifeq: Abc | abc | jednako | nejednako }}
Ako su obje ulazne vrijednosti ispravne brojčane vrijednosti, usporedit će se kao brojevi:
* <code><nowiki>{{#ifeq: 01 | 1 | jednako | nejednako }}</nowiki></code> => {{#ifeq: 01 | 1 | jednako | nejednako }} 
* <code><nowiki>{{#ifeq: "01" | "1" | jednako | nejednako }}</nowiki></code> => {{#ifeq: "01" | "1" | jednako | nejednako }} 
* <code><nowiki>{{#ifeq: 0 | -0 | jednako | nejednako }}</nowiki></code> => {{#ifeq: 0 | -0 | jednako | nejednako }}
* <code><nowiki>{{#ifeq: 1e3 | 1000 | jednako | nejednako }}</nowiki></code> => {{#ifeq: 1e3 | 1000 | jednako | nejednako }}
* <code><nowiki>{{#ifeq: {{#expr:10^3}} | 1000 | jednako | nejednako }}</nowiki></code> => {{#ifeq: {{#expr:10^3}} | 1000 | jednako | nejednako }} 

Upotreba magičnih riječi i oznaka u XML-u unutar parserskih funkcija može imati neočekivane rezultate:
* <code><nowiki>{{#ifeq: <nowiki>abc<&sol;nowiki> | <nowiki>abc<&sol;nowiki> | jednako | nejednako }}</nowiki></code> => {{#ifeq: <nowiki>abc</nowiki> | <nowiki>abc</nowiki> | jednako | nejednako }}
* <code><nowiki>{{#ifeq: <math>abc</math> | <math>abc</math> | jednako | nejednako }}</nowiki></code> => {{#ifeq: <math>abc</math> | <math>abc</math> | jednako | nejednako }} 
* <code><nowiki>{{#ifeq: {{:Posebno:PrefixIndex/{{FULLPAGENAME}}/}} | {{:Posebno:PrefixIndex/{{FULLPAGENAME}}/}} | jednako | nejednako }}</nowiki></code> => {{#ifeq: {{:Posebno:PrefixIndex/{{FULLPAGENAME}}/}} | {{:Posebno:PrefixIndex/{{FULLPAGENAME}}/}} | jednako | nejednako }} 

=== iferror ===
Parserska funkcija '''#iferror''' prima unos i vraća jedan od dva rezultata ovisno o tome vraća li unos pogrešku ili ne. Pogreškom se smatra bilo koji objekt u HTML-u s atributom ''class="error"'' poput poruka o pogrešci pri izvođenju drugih parserskih funkcija.

Sintaksa: <code><nowiki>{{#iferror:</nowiki> testni izraz | rezultat ako izraz vraća grešku | rezultat ako je izraz ispravan }}</code>

* <code><nowiki>{{#iferror: {{#expr: 1 + 2 }} | pogrešno | ispravno }}</nowiki></code> => {{#iferror: {{#expr: 1 + 2 }} | pogrešno | ispravno }}
* <code><nowiki>{{#iferror: {{#expr: 1 + X }} | pogrešno | ispravno }}</nowiki></code> => {{#iferror: {{#expr: 1 + X }} | pogrešno | ispravno }}
** <code><nowiki>{{#expr: 1 + X }}</nowiki></code> => {{#expr: 1 + X }}
Ako se izostavi rezultat pri ispravnom izrazu, vraća se rezultat testnog izraza (ako nije pogrešan). Ako se izostavi i rezultat pri pogrešci, a rezultat sadrži pogrešku, vraća se prazan rezultat <code></code>.
* <code><nowiki>{{#iferror: {{#expr: 1 + 2 }} | pogrešno }}</nowiki></code> => {{#iferror: {{#expr: 1 + 2 }} | pogrešno }}
* <code><nowiki>{{#iferror: {{#expr: 1 + X }} | pogrešno }}</nowiki></code> => {{#iferror: {{#expr: 1 + X }} | pogrešno }} 
* <code><nowiki>{{#iferror: {{#expr: 1 + 2 }} }}</nowiki></code> => {{#iferror: {{#expr: 1 + 2 }} }}
* <code><nowiki>{{#iferror: {{#expr: 1 + X }} }}</nowiki></code> => {{#iferror: {{#expr: 1 + X }} }}
* <code><nowiki>{{#iferror: {{#expr: . }} | pogrešno | ispravno }}</nowiki></code> => {{#iferror: {{#expr: . }} | pogrešno | ispravno }}
** <code><nowiki>{{#expr: . }}</nowiki></code> => {{#expr: . }}
* <code><nowiki>{{#iferror: <strong class="error">abc</strong> | pogrešno | ispravno }}</nowiki></code> => {{#iferror: <strong class="error">abc</strong> | pogrešno | ispravno }}
** <code><nowiki><strong class="error">abc</strong></nowiki></code> => <strong class="error">abc</strong>

=== ifexpr ===
Parserska funkcija '''#ifexpr''' prima matematički izraz i vraća jedan od dvaju rezultata ovisno o tome je li izraz matematički ispravan ili ne.

Sintaksa: <code><nowiki>{{#ifexpr:</nowiki> matematički izraz | rezultat ako je izraz točan | rezultat ako je izraz pogrešan }}</code>

Svi se izrazi izračunavaju jednako kao kod funkcije [[#expr]]. Rezultat izraza zatim se promatra Booleovom logikom (''istina'' ili ''laž'').

* <code><nowiki>{{#ifexpr: 1 > 0 | da | ne }}</nowiki></code> => {{#ifexpr: 1 > 0 | da | ne }}
* <code><nowiki>{{#ifexpr: 1 < 0 | da | ne }}</nowiki></code> => {{#ifexpr: 1 < 0 | da | ne }}
* <code><nowiki>{{#ifexpr: 0 = 0 | da | ne }}</nowiki></code> => {{#ifexpr: 0 = 0 | da | ne }}
* <code><nowiki>{{#ifexpr: 1 > 0 | | ne }}</nowiki></code> => {{#ifexpr: 1 > 0 | | ne }}
* <code><nowiki>{{#ifexpr: 1 > 0 }}</nowiki></code> => {{#ifexpr: 1 > 0 }}
* <code><nowiki>{{#ifexpr: floor1.5e1 = 15 | da | ne }}</nowiki></code> => {{#ifexpr: floor1.5e1 = 15 | da | ne }}
Booleova logika također je podržana:
* <code><nowiki>{{#ifexpr: 0 = 0 or 1 = 0 | da | ne }}</nowiki></code> => {{#ifexpr: 0 = 0 or 1 = 0 | da | ne }}
* <code><nowiki>{{#ifexpr: 0 = 0 and 1 = 0 | da | ne }}</nowiki></code> => {{#ifexpr: 0 = 0 and 1 = 0 | da | ne }}

=== ifexist ===
Funkcija parsera '''#ifexist''' prima naslov stranice i ispisuje vrijednost ovisno o tome postoji li stranica na lokalnom projektu.

Sintaksa: <code><nowiki>{{#ifexist:</nowiki> ime stranice | rezultat ako je stranica postoji | rezultat ako stranica ne postoji }}</code>

Provjera stranice tom funkcijom dodaje poveznicu na Posebno:Što vodi ovamo za traženu stranicu. Kad bi se primjerice na toj stranici izveo kod  <code><nowiki>{{#ifexist:Abc}}</nowiki></code>, pregled Što vodi ovamo sa stranice Abc sadržavao bi i poveznicu na tu stranicu. Provjera stranice koja ne postoji dodaje njezinu poveznicu na [[Posebno:Tražene stranice]] (vidi [[:phab:T14019]] za detalje).

Ako je stranica stvorena pod navedenim naslovom, funkcija će je tretirati kao da postoji neovisno o tome ima li stranica sadržaj ili je izbijeljena, u kakvu je obliku sadržaj koji se na njoj nalazi (wikitekst, CSS, JavaScript, modul, slika ili drugo), je li vizualno prazna (primjerice ako se sastoji samo od kategorija ili međuwikipoveznica) i služi li za preusmjeravanje. Funkcija će tvrditi da stranica ne postoji samo ako je poveznica na stranicu crvena; u to mogu spadati i stranice koje su postojale, ali su potom izbrisane.
* <code><nowiki>{{#ifexist: Pomoć:Funkcije parsera | postoji | ne postoji }}</nowiki></code> => {{#ifexist: Pomoć:Funkcije parsera | postoji | ne postoji }}
* <code><nowiki>{{#ifexist: ABCPomoć:Funkcije parseraABC | postoji | ne postoji }}</nowiki></code> => {{#ifexist: ABCPomoć:Funkcije parseraABC | postoji | ne postoji }}
Ako pružimo poveznice na poruke sučelja, funkcija će zaključiti da one postoje isključivo ako postoji lokalna inačica stranice.
* <code><nowiki>{{#ifexist: MediaWiki:Talkpagetext | postoji | ne postoji }}</nowiki></code> => {{#ifexist: MediaWiki:Talkpagetext | postoji | ne postoji }}
* <code><nowiki>{{#ifexist: MediaWiki:Title-invalid-too-long | postoji | ne postoji }}</nowiki></code> => {{#ifexist: MediaWiki:Title-invalid-too-long | postoji | ne postoji }} {{efn|Ova poruka postoji na TranslateWikiju, i koristi se u sučelju, ali ne postoji lokalno premoštenje ovog prijevoda}}
Funkcija ispravno radi i s posebnim stranicama koje stvaraju proširenja instalirana na trenutačnom projektu.
* <code><nowiki>{{#ifexist: Special:Watchlist | postoji | ne postoji }}</nowiki></code> => {{#ifexist: Special:Watchlist | postoji | ne postoji }}
* <code><nowiki>{{#ifexist: Posebno:Praćene stranice | postoji | ne postoji }}</nowiki></code> => {{#ifexist: Posebno:Praćene stranice | postoji | ne postoji }}
* <code><nowiki>{{#ifexist: Special:Checkuser | postoji | ne postoji }}</nowiki></code> => {{#ifexist: Special:Checkuser | postoji | ne postoji }} {{efn|Na ovom je projektu aktivno proširenje [[:mw:Extension:Checkuser]]}}
* <code><nowiki>{{#ifexist: Posebno:Provjeri suradnika | postoji | ne postoji }}</nowiki></code> => {{#ifexist: Posebno:Provjeri suradnika | postoji | ne postoji }}
Pri provjeri datoteka upotreba prefiksa ''Datoteka:'' ili ''File:'' provjerit će postojanje lokalne inačice datoteke, neovisno o tome postoji li datoteka na [[:commons:|Zajedničkom poslužitelju]]. Upotreba prefiksa ''Media:'' pretražit će i Zajednički poslužitelj.

Primjer datoteke sa Zajedničkog poslužitelja:
* <code><nowiki>{{#ifexist: Datoteka:JAB-code.png | postoji | ne postoji }}</nowiki></code> => {{#ifexist: Datoteka:JAB-code.png | postoji | ne postoji }}
* <code><nowiki>{{#ifexist: File:JAB-code.png | postoji | ne postoji }}</nowiki></code> => {{#ifexist: File:JAB-code.png | postoji | ne postoji }}
* <code><nowiki>{{#ifexist: Media:JAB-code.png | postoji | ne postoji }}</nowiki></code> => {{#ifexist: Media:JAB-code.png | postoji | ne postoji }}
Primjer lokalne datoteke:
* <code><nowiki>{{#ifexist: Datoteka:EWTN Logo.svg | postoji | ne postoji }}</nowiki></code> => {{#ifexist: Datoteka:EWTN Logo.svg | postoji | ne postoji }}
* <code><nowiki>{{#ifexist: File:EWTN Logo.svg | postoji | ne postoji }}</nowiki></code> => {{#ifexist: File:EWTN Logo.svg | postoji | ne postoji }}
* <code><nowiki>{{#ifexist: Media:EWTN Logo.svg | postoji | ne postoji }}</nowiki></code> => {{#ifexist: Media:EWTN Logo.svg | postoji | ne postoji }}

Funkcija ne radi za međuwikipoveznice:
* <code><nowiki>{{#ifexist: :en:Borg | postoji | ne postoji }}</nowiki></code> => {{#ifexist: :en:Borg | postoji | ne postoji }}
* <code><nowiki>{{#ifexist: :mw:Help:Extension:ParserFunctions | postoji | ne postoji }}</nowiki></code> => {{#ifexist: :mw:Help:Extension:ParserFunctions | postoji | ne postoji }}

==== Ograničenja ifexist ====
Funkcija '''#ifexist''' smatra se zahtjevnom parserskom funkcijom. Svaka stranica na projektu dopušta zvanje ograničenog broja zahtjevnih funkcija (obično njih 500). U to se ograničenje ubrajaju i zahtjevne funkcije pozvane unutar predložaka u članku. Svaka zahtjevna funkcija pozvana nakon dostizanja tog ograničenja vratit će rezultat ''false'' (negativnu granu funkcije) bez provjere rezultata.

=== switch ===
Parserska funkcija '''#switch''' uspoređuje jednu ulaznu vrijednost s više mogućih ogranaka i vraća izlaznu vrijednost asociranu uz ogranak u kojem je pronađena podudarnost. 

Sintaksa: <pre><nowiki>{{#switch: vrijednost koju uspoređujemo
 | slučaj1 = rezultat1
 | slučaj2 = rezultat2
 | ...
 | slučajN = rezultatN
 | #default = rezultat ako nema podudarnosti
}}</nowiki></pre>

Ako se grana #default izostavi, a nema podudarnosti, funkcija neće ispisati nikakav rezultat. Zadnja grana bez jednakosti predodređeno je ''default'', pa se tekst "#default=" može i izostaviti.

Primjeri:
* <code><nowiki>{{#switch: abc |abc = rezultat1 |def = rezultat2 |ghi = rezultat3 |#default = ništa}}</nowiki></code> => {{#switch: abc |abc = rezultat1 |def = rezultat2 |ghi = rezultat3 |#default = ništa}} 
* <code><nowiki>{{#switch: def |abc = rezultat1 |def = rezultat2 |ghi = rezultat3 |#default = ništa}}</nowiki></code> => {{#switch: def |abc = rezultat1 |def = rezultat2 |ghi = rezultat3 |#default = ništa}}
* <code><nowiki>{{#switch: ghi |abc = rezultat1 |def = rezultat2 |ghi = rezultat3 |#default = ništa}}</nowiki></code> => {{#switch: ghi |abc = rezultat1 |def = rezultat2 |ghi = rezultat3 |#default = ništa}}
* <code><nowiki>{{#switch: zzz |abc = rezultat1 |def = rezultat2 |ghi = rezultat3 |#default = ništa}}</nowiki></code> => {{#switch: zzz |abc = rezultat1 |def = rezultat2 |ghi = rezultat3 |#default = ništa}}
* <code><nowiki>{{#switch: zzz |abc = rezultat1 |def = rezultat2 |ghi = rezultat3 | ništa}}</nowiki></code> => {{#switch: zzz |abc = rezultat1 |def = rezultat2 |ghi = rezultat3 | ništa}}
Kao što je bio slučaj s [[#ifeq]], ako je vrijednost koja se ispituje numerička, uspoređivat će se kao broj:
* <code><nowiki>{{#switch: 0 + 1 | 1 = jedan | 2 = dva | drugo }}</nowiki></code> => {{#switch: 0 + 1 | 1 = jedan | 2 = dva | drugo }}
* <code><nowiki>{{#switch: {{#expr: 0 + 1}} | 1 = jedan | 2 = dva | drugo }}</nowiki></code> => {{#switch: {{#expr: 0 + 1}} | 1 = jedan | 2 = dva | drugo }}
Funkcija razlikuje velika i mala slova:
* <code><nowiki>{{#switch: a | a = A | b = B | C }}</nowiki></code> => {{#switch: a | a = A | b = B | C }}
* <code><nowiki>{{#switch: A | a = A | b = B | C }}</nowiki></code> => {{#switch: A | a = A | b = B | C }}
Funkcija staje čim se pronađe prva podudarnost. Sva ostala poklapanja (ako postoje) ignoriraju se:
* <code><nowiki>{{#switch: b | f = abc | b = def | b = ghi | ništa }}</nowiki></code> => {{#switch: b | f = abc | b = def | b = ghi | ništa }}

==== Grupiranje rezultata ====
Funkcija podržava mogućnost da nekoliko slučajeva vraća isti rezultat:
<pre><nowiki>{{#switch: vrijednost
 | 1 = prvi
 | 2 = drugi
 | 3|4|5 = treći do peti
 | 6|7 = šesti ili sedmi
 | 8 = osmi
 | #default: više od osam
}}</nowiki></pre>
U tom slučaju vrijednosti 3, 4 ili 5 vraćaju rezultat "treći do peti", a vrijednosti 6 ili 7 vraćaju "šesti ili sedmi".

==== Upotreba uz parametre predložaka ====
Funkcija kao vrijednost može provjeravati i vrijednost parametra predloška. Za razliku od funkcije [[#if]] uz navođenje parametra nije nužno pisati znak <code>|</code>. Primjerice:
* <code><nowiki>{{#switch: {{{1}}} |abc = rezultat1 |def = rezultat2 |#default = ništa}}</nowiki></code>
Ako je u gornjem kodu prvi parametar jednak vrijednosti "abc", funkcija će vratiti "rezultat1", a ako je jednak "def", funkcija će vratiti "rezultat2". Ako prvi parametar nije naveden ili nema vrijednost, ili ako ima vrijednost koja nije navedena u funkciji switch, funkcija će vratiti "ništa".

== time ==
{{Glavni|Pomoć:Vremenska funkcija}}

== Bilješke ==
{{notelist}}

[[Kategorija:Pomoć]]