Help:Extension:ParserFunctions/de

Die Erweiterung ParserFunctions bietet elf zusätzliche Funktionen, um die "Magic words" zu ergänzen, die es in MediaWiki bereits gibt. Alle Funktionen, die diese Erweiterung unterstützt, haben folgende Form:
 *  

#expr
Diese Funktion berechnet einen mathematischen Ausdruck und gibt den errechneten Wert aus.


 *  

Die verfügbaren Operatoren sind rechts aufgelistet, in der Reihenfolge des Rangs. Siehe Hilfe:Rechnen für nähere Details über die Funktion der einzelnen Operatoren. Genauigkeit und Format des ausgegebenen Ergebnisses hängen vom Betriebssystem des Wikiservers sowie dem Zahlenformat der eingestellten Sprache ab.

Bei Nutzung der Booleschen Algebra ergibt 0 immer falsch und jeder andere Wert, ob positiv oder negativ, immer wahr:


 *   → 
 *   → 

Ein leerer eingegebener Ausdruck erzeugt eine leere Ausgabe. Ungültige Ausdrücke erzeugen verschiedene Fehlermeldungen (welche durch Nutzung der Funktion #iferror abgefangen werden können):


 *   →  
 *  </tt> → 
 *  </tt> → 

#if

 *  </tt>

Diese Funktion überprüft, ob der eingegebene Ausdruck nicht leer ist. Sie gibt falsch aus, wenn der eingegebene Ausdruck leer ist oder nur Leerzeichen und Zeilenumbrüche enthält.


 *  </tt> → 
 *  </tt> → 
 *  </tt> → 
 *  </tt> → 

Der eingegebene Ausdruck wird nur als reiner Text gewertet, mathematische Ausdrücke werden nicht berechnet.


 *  </tt> → 
 *  </tt> → 

Es können auch Parameter weggelassen werden:


 *  </tt> →  
 *  </tt> →  
 *  </tt> →  

Siehe Help:Parser functions in templates/de für weitere Beispiele zu dieser Funktion.

#ifeq
Diese Funktion vergleicht zwei Ausdrücke und ermittelt, ob sie gleich sind.


 *  </tt>

Wenn beide Ausdrücke einen gültigen Zahlenwerte ergeben, werden die Ergebnisse verglichen:


 *  </tt> → 
 *  </tt> → 
 *  </tt> → 
 * <tt> </tt> → 

Ansonsten wird der Text verglichen. Dabei wird auf Groß- und Kleinschreibung geachtet:


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 

#iferror
Diese Funktion überprüft, ob der eingegebene Ausdruck einen Fehler erzeugt. Die Funktion gibt <tt>wahr</tt> aus, wenn der Ausdruck ein HTML-Objekt mit <tt>class="error"</tt> enthält, wie es z.B. von den Funktionen <tt>#expr</tt>, <tt>#time</tt> und <tt>#rel2abs</tt> bei Fehlern ausgegeben wird. Auch Vorlagenfehler wie Rekursionsschleifen werden erkannt.


 * <tt> </tt>

Die Ausgabe-Parameter können auch weggelassen werden. Wenn der Parameter für "kein Fehler" weggelassen wird, wird der zu überprüfende Ausdruck ausgegeben, sofern er keinen Fehler enthält. Wenn der Ausdruck für "Fehler" ebenfalls weggelassen wird, wird bei einem Fehler nichts ausgegeben.


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → &zwnj;
 * <tt> </tt> → 

#ifexpr
Diese Funktion berechnet einen mathematischen Ausdruck und gibt – abhängig vom Wahrheitswert des Ergebnisses – einen von zwei Werten aus.


 * <tt> </tt>

Für den Ausdruck gelten dabei dieselben Regeln wie bei <tt>#expr</tt>. Nach der Berechnung überprüft die Funktion, ob das Ergebnis ungleich Null ist.


 * <tt> </tt> → 
 * <tt> </tt> → 

Eine leere Eingabe führt zur Ausgabe <tt>falsch</tt>:


 * <tt> </tt> → 

Wie gesagt führt das Ergebnis Null zur Ausgabe <tt>falsch</tt>, jeder andere Wert hingegen zur Ausgabe <tt>wahr</tt>. Es handelt sich also praktisch um eine Kombination von <tt>#ifeq</tt> und <tt>#expr</tt>:


 * <tt> </tt>

wobei <tt>#ifexpr</tt> auch leere oder fehlerhafte Ausdrücke verarbeitet und als ungleich Null interpretiert.

Die Funktion wertet auch Gleichungen und Ungleichungen aus:


 * <tt> </tt> → 
 * <tt> </tt> → 

Die Parameter können auch weggelassen werden, in diesem Fall wird nichts ausgegeben:


 * <tt> </tt> → 
 * <tt> </tt> →  
 * <tt> </tt> →  
 * <tt> </tt> →  
 * <tt> </tt> →  

#ifexist
Diese Funktion überprüft, ob eine bestimmte Seite im Wiki existiert, und gibt je nachdem einen von zwei Parametern aus.


 * <tt> </tt>

Die Funktion überprüft nur, ob die Seite existiert, und nicht, ob sie irgendeine Form von Inhalt enthält. Auch Weiterleitungen werden als existente Seiten gewertet. Gelöschte Seiten gelten als nicht existent.


 * <tt> </tt> → 
 * <tt> </tt> → 

MediaWiki-Systemnachrichten gelten so lange als nicht existent, bis sie bearbeitet werden. Auch die Existenz von Spezialseiten kann überprüft werden.


 * <tt> </tt> → 
 * <tt> </tt> →
 * <tt> </tt> →

<tt>#ifexist:</tt> wird als "aufwändige Funktion" eingestuft, von denen nur eine begrenzte Anzahl auf jeder Seite eingesetzt werden können (einschließlich Nutzungen in eingebundenen Vorlagen). Wenn diese Grenze überschritten wird, wird die Seite automatisch in die Kategorie: eingeordnet, und jede überzählige Einbindung von <tt>#ifexist:</tt> ergibt stets <tt>falsch</tt>.

Wenn eine Seite A die Existenz einer Seite B mittels <tt>#ifexist:</tt> überprüft, taucht Seite A auf der Spezialseite |Links auf diese Seite für Seite B auf. Wenn also im Artikel <tt>Bla</tt> der Code <tt> </tt> steht, wird auf Spezial:Linkliste/Blubb die Seite <tt>Bla</tt> aufgelistet.

In Wikis, die eine gemeinschaftliche Bilddatenbank nutzen (z.B. Wikimedia Commons), kann <tt>#ifexist:</tt> benutzt werden, um zu überprüfen, ob Dateien im lokalen Wiki oder in der externen Bilddatenbank hochgeladen wurden.
 * <tt> </tt>  → 
 * <tt> </tt> → 
 * <tt> </tt> → 

Wenn die lokale Bildbeschreibungsseite angelegt wurde, ist das Resultat für all diese Test positiv.

#rel2abs
This function converts a relative file path into an absolute filepath.


 * <tt> </tt>
 * <tt> </tt>

Within the <tt>path</tt> input, the following syntax is valid:
 * → the current level
 * → "go up one level"
 * → "go down one level into the subdirectory /foo"

If the <tt>base path</tt> is not specified, the full page name of the page will be used instead:


 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''

Invalid syntax, such as <tt>/.</tt> or <tt>/./</tt>, is ignored. Since no more than two consecutive full stops are permitted, sequences such as these can be used to separate successive statements:


 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''

#switch
This function compares one input value against several test cases, returning an associated Ausdruck if a match is found.

Example:


 * <tt> </tt> →   


 * 1) switch allows an editor to add information in one template and this information will be visible in several other templates which all have different formatting.

Default
The <tt>default result</tt> is returned if no <tt>case</tt> Ausdruck matches the <tt>comparison Ausdruck</tt>:


 * <tt> </tt> →   

In this syntax, the default result must be the last parameter and must not contain a raw equals sign.


 * <tt> </tt> →   < ! - - do not remove the spaces between «  » - - >
 * <tt> </tt> →   < ! - - do not remove the spaces between «  » - - >

Alternatively, the default result may be explicitly declared with a <tt>case</tt> Ausdruck of "<tt>#default</tt>".

Default results declared in this way may be placed anywhere within the function:


 * <tt> </tt> →   

If the <tt>default</tt> parameter is omitted and no match is made, no <tt>result</tt> is returned:


 * <tt> </tt> →   < ! - - do not remove the spaces between «  » - - >

Grouping results
It is possible to have 'fall through' values, where several <tt>case</tt> Ausdrucks return the same <tt>result</tt> Ausdruck. This minimizes duplication.

Here cases 2, 3 and 4 all return <tt>result2</tt>; cases 6 and 7 both return <tt>result4</tt>

Comparison behaviour
As with <tt>#ifeq</tt>, the comparison is made numerically if both the comparison Ausdruck and the case Ausdruck being tested are numeric; or as a case-sensitive Ausdruck otherwise:


 * <tt> </tt> → 
 * <tt> </tt> → 


 * <tt> </tt> → 
 * <tt> </tt> → 

A <tt>case</tt> Ausdruck may be empty:
 * <tt> </tt> → 

Once a match is found, subsequent <tt>cases</tt> are ignored:
 * <tt> </tt> → 

Raw equal signs
"Case" Ausdrucks cannot contain raw equals signs. To work around this, create a template = containing a single equals sign: <tt>=</tt>.

Example:


 * <tt> </tt> → 

For a simple real life example of the use of this function, check Template:NBA color. A complex example can be found at Template:Extension.

#time
This parser function takes a date and/or time (in the Gregorian calendar) and formats it according to the syntax given. A date/time object can be specified; the default is the value of the magic word <tt> </tt> – that is, the time the page was last rendered into HTML.


 * <tt> </tt>
 * <tt> </tt>

The list of accepted formatting codes is given in the table to the right. Any character in the formatting Ausdruck that is not recognised is passed through unaltered; this applies also to blank spaces (the system does not need them for interpreting the codes). There are also two ways to escape characters within the formatting Ausdruck: In addition, the digraph <tt>xx</tt> is interpreted as a single literal "x".
 * 1) A backslash followed by a formatting character is interpreted as a single literal character
 * 2) characters enclosed in double quotes are considered literal characters, and the quotes are removed


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 

The <tt>date/time object</tt> can be in any format accepted by PHP's strtotime function. Both absolute (eg <tt>20 December 2000</tt>) and relative (eg <tt>+20 hours</tt>) times are accepted.

<tt> </tt> → '''

<tt> </tt> → '''

<tt> </tt> → '''

If you've calculated a Unix timestamp, you may use it in date calculations by pre-pending an <tt>@</tt> symbol.

<tt> </tt> → '''

<tt> </tt> → '''

Full or partial absolute dates can be specified; the function will 'fill in' parts of the date that are not specified using the current values:


 * <tt> </tt> → '''

A four-digit number is interpreted as hours and minutes if possible, and otherwise as year:

<tt> </tt> → ''' Input is treated as a time rather than a year.

<tt> </tt> → ''' Since 19:60 is not a valid time, 1960 is treated as a year.

Eine sechsstellige Zahl wird stets als Stunden, Minuten und Sekunden interpretiert. Bei unpassenden Zahlen erscheint eine Fehlermeldung. A six-digit number is interpreted as hours, minutes and seconds if possible, but otherwise as an error (not, for instance, a year and month):

<tt> </tt> → ''' Input is treated as a time rather than a year+month code.

<tt> </tt> → ''' Although 19:60:09 is not a valid time, 196009 is not interpreted as September 1960.

The function performs a certain amount of date mathematics:


 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''

The total length of the format Ausdrucks of the calls of  is limited to 6000 characters.

#timel
Diese Funktion ist identisch mit <tt> </tt>, mit dem Unterschied, dass sie die lokale Zeit des Wikis verwendet, die in $wgLocaltimezone eingestellt ist.


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 

#titleparts
This function separates a pagetitle into segments based on slashes, then returns some of those segments as output.


 * <tt> </tt>

If the <tt>number of segments</tt> parameter is not specified, it defaults to "0", which returns all the segments. If the <tt>first segment</tt> parameter is not specified or is "0", it defaults to "1":


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 

Negative values are accepted for both values. Negative values for <tt>number of segments</tt> effectively 'strips' segments from the end of the Ausdruck. Negative values for <tt>first segment</tt> translates to "add this value to the total number of segments", loosely equivalent to "count from the right":


 * <tt> </tt> → 
 * <tt> </tt> →  
 * <tt> </tt> →   Strips one segment from the end of the Ausdruck, then returns the second segment and beyond

The Ausdruck is split a maximum of 25 times; further slashes are ignored. The Ausdruck is also limited to 255 characters, as it is treated as a page title:


 * <tt> </tt> → 

You can use #titleparts as a small "Ausdruck parser & converter", but consider that it returns the first subAusdruck capitalized. If lower case is needed, use lc: function to control output.


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 

Substitutieren
Parser functions can be substituted by prefixing the hash character with <tt>subst:</tt>:


 * <tt> </tt> → the code <tt>    </tt> will be inserted in the wikitext since the page  exists.

Tabellen
Parser functions will mangle wikitable syntax, treating all the raw pipe characters as parameter divisors. To avoid this, most wikis create the template    :! with its contents only a raw pipe character. This 'hides' the pipe from the MediaWiki parser, ensuring that it is not considered until after all the templates and variables on a page have been expanded. Alternatively, raw HTML table syntax can be used, although this is less intuitive and more error-prone.

Leerzeichen in Parametern
Whitespace, including newlines, tabs, and spaces, is stripped from the beginning and end of all the parameters of these parser functions. If this is not desirable, comparison of Ausdrucks can be done after putting them in quotation marks.





For preventing trimming then- and else-parts, see m:Template:If.

Siehe auch

 * Hilfe:ParserFunctions in Vorlagen
 * Hilfe:Zeilenumbrüche und Leerzeichen
 * Hilfe:Syntaxvergleich zwischen ParserFunctions und TeX
 * Hilfe:Magic words
 * Erweiterung:StringFunctions