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 Tests <tt>existiert</tt>.

#rel2abs
Diese Funktion wandelt einen relativen Dateipfad in einen absoluten um.


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

Bei der Pfadeingabe kann folgende Syntax genutzt werden:
 * → aktuelles Verzeichnis
 * → übergeordnetes Verzeichnis
 * → Unterverzeichnis /blubb"

Wenn der Grundpfad nicht angegeben wird, wird stattdessen der Name der aktuellen Seite verwendet.

Funktionsbeispiele:


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

Mehr als zwei Punkte sind nicht erlaubt. Für ausführlichere Strukturen ist folgende Vorgehensweise möglich:


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

#switch
Diese Funktion vergleicht einen eingegebenen Ausdruck mit mehreren möglichen Fällen, und gibt bei einer Übereinstimmung ein Ergebnis aus.

Beispiel:


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

<tt> #switch </tt> erlaubt es also, in einer Vorlage bestimmte Informationen zu speichern, und diese bei Aufruf wiederzugeben.

Standardausgabe
Die Standardausgabe wird ausgegeben, wenn keine eingetragene Möglichkeit mit dem eingegebenen Ausdruck übereinstimmt. Sie muss stets als letzter Parameter eingetragen werden und darf kein Gleichheitszeichen enthalten. Bei Missachtung wird nichts ausgegeben:


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

Wahlweise kann die Standardausgabe auch mit <tt>#default =</tt> gekennzeichnet werden.

In diesem Fall kann die Standardausgabe auch an jeder Stelle der Funktion stehen:


 * <tt> </tt> →   

Wenn keine Standardausgabe festgelegt ist, wird nichts ausgegeben:


 * <tt> </tt> →   

Möglichkeiten zusammenfassen
Wenn bei mehreren Möglichkeiten die gleiche Ausgabe erfolgen soll, reicht es, den Ausgabetext bei der letzten dieser Möglichkeiten anzugeben:

In diesem Fall ergäben die Möglichkeiten 2, 3 und 4 allesamt die Ausgabe B und die Möglichkeiten 6 und 7 beide die Ausgabe D.

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> → 

Substituieren
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