Help:Parserfuncties

Deze MediaWiki extensie is een verzameling parserfuncties. Deze hebben in het algemeen de volgende opbouw:

{{#functienaam: argument 1 | argument 2 | argument 3...}}

Deze module definieert momenteel zes functies, te weten: expr, if, ifeq, ifexist, ifexpr en switch.

Inhoud 1 Functies 1.1 expr 1.2 if 1.3 ifeq 1.4 ifexist 1.4.1 Voorbeelden: 1.5 ifexpr 1.6 switch 2 Installeren 3 Externe koppelingen 4 Zie ook

[bewerk] Functies

[bewerk] expr

De expr functie berekent rekenkundige uitdrukkingen. De ondersteunde bewerkingen (ongeveer in volgorde van voorrang) zijn:

Teken	Bewerking	Voorbeeld
*	Vermenigvuldiging	{{#expr: 30 * 7}} = 210
/ of div	Deling	{{#expr: 30 / 7}} = 4.2857142857143
+	Optelling	{{#expr: 30 + 7}} = 37
-	Aftrekking (or negatie)	{{#expr: 30 - 7}} = 23
mod	Modulo, levert de rest na deling	{{#expr: 30 mod 7}} = 2
round	Rondt een getal (omhoog of omlaag) af op het aangegeven aantal cijfers na het decimaalteken, rechts ingegeven	{{#expr: 30.7 round 0}} = 31 {{#expr: 30 / 7 round 7}} = 4.2857143
=	Gelijkheid	{{#expr: 30 = 7}} = 0
<> of !=	Ongelijkheid	{{#expr: 30 <> 7}} = 1
<	Kleiner dan	{{#expr: 30 < 7}} = 0
>	Groter dan	{{#expr: 30 > 7}} = 1
<=	Kleiner of gelijk	{{#expr: 30 <= 7}} = 0
>=	Groter of gelijk	{{#expr: 30 >= 7}} = 1
and	Logische EN	{{#expr: 30 and 7}} = 1
or	Logische OF	{{#expr: 30 or 7}} = 1
not	Logische NIET	{{#expr: not 7}} = 0
( )	Groeperingstekens	{{#expr: (30 + 7) * 7 }} = 259

De booleaanse bewerkingen beschouwen 0 als onwaar en 1 als waar. Getallen hebben "." als decimaalteken. Geen ondersteuning van FORTRAN-achtige wetenschappelijke notatie.

Voorbeeld:

{{ #expr: (100 - 32) / 9 * 5 round 0 }}

geeft:

38

wat neerkomt op 100°F in °C, afgerond op het dichtstbijzijnde gehele getal.

[bewerk] if

De if functie is een als-dan-anders constructie. De opbouw is:

{{ #if: <condition> | <then text> | <else text> }}

Als de conditie een lege tekenreeks of slechts witruimte oplevert dan merken we deze aan als onwaar, en geeft de else text terug. Anders is de uitkomst de then text. De else text hoeft er niet te zijn. In dat geval is de uitvraging blanco wanneer de conditie onwaar is.

Een illustratie:

                      {{Template|parameter=something}}  {{Template}} {{Template|parameter=}}
                                     |                        |                |
                                     |                        |                |
                                     |                        |                |
{{ #if: {{{parameter|}}} | Parameter is defined. | Parameter is undefined, or empty }}

Merk op dat de if functie de not noch de "=" tekens en evenmin rekenkundige uitdrukkingen ondersteunt. {{#if: 1 = 2|ja|nee}} levert als resultaat "ja" want de tekenreeks "1 = 2" is niet blanco. De bedoeling is een "als gedefinieerd" constructie. Voor het vergelijken van tekenreeksen dient de ifeq. Voor het vergelijken van getallen de ifexpr.

[bewerk] ifeq

ifeq vergelijkt twee tekenreeksen en retourneert een andere tekenreeks afhankelijk van het resultaat van de vergelijking. Deze is als volgt opgebouwd:

{{ #ifeq: <comparison text 1> | <comparison text 2> | <equal text> | <not equal text> }}

[bewerk] ifexist

ifexist geeft een van twee mogelijke waarden, afhankelijk van het bestaan van een lemma.

{{ #ifexist: <lemma> | <then text> | <else text> }}

Argumenten:

1. naam van de gevraagde pagina
2. tekst of waarde indien de pagina bestaat
3. tekst of waarde indien de pagina niet bestaat

N.B.: De functie is case-sensitive v.w.b. alle tekens behalve het eerste.

[bewerk] Voorbeelden:

Aangenomen dat een lemma Test bestaat:

{{#ifexist: Test | ja | nee}} = ja
{{#ifexist: test | ja | nee }} = ja
{{#ifexist: tEST | ja | nee }} = nee (!)

{{#ifexist: m:Help:Calculation | Yes | No }} geeft No: de functie 
    werkt niet voor pagina's met een interwiki prefix, hoewel de 
    pagina in kwestie wél bestaat.

[bewerk] ifexpr

ifexpr evalueert een rekenkundige bewerking en geeft een van twee tekenreeksen als uitkomst.

{{ #ifexpr: <expression> | <then text> | <else text> }}

In het geval van nul als uitkomst dan resulteert de else text zo niet de then text. Uitdrukkingsopbouw is analoog aan expr.

[bewerk] switch

switch vergelijkt een enkele waarde met meerdere andere en geeft een tekenreeks terug als gelijkheid optreedt. In beginsel is de opbouw:

 {{ #switch: <vergelijkingswaarde>
 | <waarde1>=<uitkomst1>
 | <waarde2>=<uitkomst2>
 | ...
 | <waarden>=<uitkomstn> 
 | <verstekuitkomst>
 }}

switch loopt elke waarde af totdat deze gelijkheid vindt met de vergelijkingswaarde. Vindt het die, dan is de bij die waarde horende uitkomst het resultaat (de tekenreeks na het is-teken). Vindt het die niet, en de laatste optie bevat geen is-teken, dan resulteert de verstekuitkomst.

Merk op dat het mogelijk is waarden te laten "doorlopen" (ter reducering van de noodzaak voor dubbele uitkomsten). Bijvoorbeeld:

 {{ #switch: <vergelijkingswaarde>
 | <waarde1>
 | <waarde2>
 | <waarde3>=<uitkomst3>
 | ...
 | <waarden>=<uitkomstn> 
 | <verstekuitkomst>
 }}

De bijzonderheid is dat waarde¹ en waarde² geen is-teken bevatten. Wanneer gelijkheid hier optreedt krijgen ze de bij value³ genoemde uitkomst.

[bewerk] Installeren

Zie voor de rode koppelingen Installeer je eigen Wiki.
Download beide bestanden en zet ze in een nieuwe map met de naam ParserFunctions in je extensions map.

• Expr.php
• ParserFunctions.php

Plaats dan de nu volgende regel aan het eind van je LocalSettings.php:

require_once( "$IP/extensions/ParserFunctions/ParserFunctions.php" );

Je kan de codeboom hier afstruinen:

• ParserFunctions in MediaWiki SVN

[bewerk] Externe koppelingen

• m:ParserFunctions
• De discussie aangaande ParserFunctions in het archief Wikitech-l e-maillijst
• ParserFunctions proefballon
• en:Category:Templates using ParserFunctions

[bewerk] Zie ook