Help:Extension:ParserFunctions/de

Die Erweiterung bietet elf zusätzliche Parserfunktionen, um die "" zu ergänzen, die es in MediaWiki bereits gibt. (Sie kann konfiguriert werden, um zusätzliche Parser-Funktionen zur Vearbeitung von Strings zur Verfügung zu stellen, diese sind dokumentiert.) Alle Funktionen, die diese Erweiterung unterstützt, haben folgende Form:

#expr
Diese Funktion berechnet einen mathematischen Ausdruck und gibt den errechneten Wert aus. Diese Funktion steht über die -Funktion auch in  zur Verfügung.



Die verfügbaren Operatoren sind rechts aufgelistet, in der Reihenfolge ihrer Anwedung. Siehe Help:Calculation (englisch) 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  und jeder andere Wert, ob positiv oder negativ, immer  :



Ein leerer eingegebener Ausdruck erzeugt eine leere Ausgabe. Ungültige Ausdrücke erzeugen eine von mehreren möglichen Fehlermeldungen, die durch Nutzung der Funktion  abgefangen werden können:



Die Reihenfolge der Additions- und Subtraktionsoperanden vor oder nach einer Zahl ist bedeutend und kann als positiver oder negativer Wert eingesetzt werden anstelle eines Operanden mit fehlerhafter Eingabe:



Beachten Sie, dass Sie bei Verwendung der Ausgabe von magischen Wörtern diese im Rohformat formatieren müssen, um Kommas zu entfernen und die Ziffern zu übersetzen. Beispielsweise führt zu, wobei wir 0 wollen, das mit   abgerufen werden kann. Dies ist besonders wichtig in einigen Sprachen, in denen Ziffern übersetzt werden. Beispielsweise erzeugt in Bengali ৩০,০৬১.



Runden
Rundet die Zahl links auf ein vielfaches von 1/10 hoch den gekürzten Wert der Zahl rechts.

Um auf- oder abzurunden benutze  bzw. .

Strings
Die Ausdrücke funktionieren nur mit zahlenähnlichen Werten, denn sie können nicht Funktionen oder Zeichen vergleichen. kann stattdessen verwendet werden.



#if
Diese Funktion wertet einen Testring aus und stellt fest, ob er leer ist oder nicht. Ein Teststring, der nur Leerzeichen enthält, wird als leer betrachtet.





Diese Funktion testet zuerst, ob der erste Parameter nicht leer ist. Wenn der erste Parameter nicht leer ist, zeigt die Funktion den zweiten Parameter. Wenn der erste Parameter leer ist oder nur Weißraumzeichen enthält (Leerzeichen, neue Zeilen etc.), wird der dritte Parameter ausgegeben.



Der Testausdruck wird immer als reiner Text interpretiert, also werden mathematische Ausdrücke nicht evaluiert:



Der letzte Parameter (false) kann weggelassen werden:



Die Funktion kann verschachtelt sein. Verschachteln Sie dazu die innere -Funktion in ihrer vollständigen Form anstelle eines Parameters der einschließenden  -Funktion. Bis zu sieben Verschachtelungsebenen sind möglich, obwohl dies vom Wiki oder einem Speicherlimit abhängen kann.

Sie können auch einen Parameter als Teststring in Ihrer -Anweisung verwenden. Sie müssen sicherstellen, dass Sie das  (Pipe-Symbol) nach dem Namen der Variablen hinzufügen. (Wenn der Parameter also keinen Wert hat, wird er zu einer leeren Zeichenfolge anstelle der Zeichenfolge „ “ ausgewertet.)



Siehe für weitere Beispiele zu dieser Parserfunktion.

#ifeq
Diese Parserfunktion vergleicht zwei Eingabezeichenfolgen, bestimmt, ob sie identisch sind, und gibt basierend auf dem Ergebnis eine von zwei Zeichenfolgen zurück. Wenn mehr Vergleiche und Ausgabestrings erforderlich sind, ziehen Sie die Verwendung von  in Betracht.



Wenn beide Ausdrücke gültige numerische Werte sind, werden die Ausdrücke zahlenmäßig verglichen:



Andernfalls wird der Vergleich textmäßig vollzogen, dieser Vergleich beachtet die Groß- und Kleinschreibung:


 * →  (vergleiche mit dem ähnlichen Beispiel oben, aber ohne Anführungszeichen)
 * →  (vergleiche mit dem ähnlichen Beispiel oben, wo   eine gültige erste Zahl anzeigt)
 * →  (vergleiche mit dem ähnlichen Beispiel oben, aber ohne Anführungszeichen)
 * →  (vergleiche mit dem ähnlichen Beispiel oben, wo   eine gültige erste Zahl anzeigt)

Betrachten Sie als praktisches Beispiel ein vorhandenes , das den Parser verwendet, um zwischen zwei Standardzeiten zu wählen, kurz und lang. Es nimmt den Parameter als erste Eingabe, um ihn mit der Zeichenfolge „short“ zu vergleichen – es gibt keine Konvention für die Reihenfolge, aber es ist einfacher zu lesen, wenn der Parameter an erster Stelle steht. Der Vorlagenquelltext sieht so aus:



folgendes ergibt sich:


 * → 20
 * → 40
 * → 40

#iferror
Diese Funktion überprüft, ob der eingegebene Ausdruck einen Fehler erzeugt. Die Funktion gibt  aus, wenn der Ausdruck ein HTML-Objekt mit   enthält, wie es z.B. von den Funktionen ,   und   bei Fehlern ausgegeben wird. Auch Vorlagenfehler wie Rekursionsschleifen werden erkannt.



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


 * → &zwnj;
 * → &zwnj;
 * → &zwnj;
 * → &zwnj;
 * → &zwnj;
 * → &zwnj;

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



Für den Ausdruck  gelten dabei dieselben Regeln wie bei. Nach der Berechnung überprüft die Funktion, ob das Ergebnis ungleich Null ist (Boolesch: true = 1/false = 0).

Eine leere Eingabe führt zur Ausgabe :



Wie gesagt führt das Ergebnis Null zur Ausgabe, jeder andere Wert hingegen zur Ausgabe. Es handelt sich also praktisch um eine Kombination von  und  :



außer für einen leeren oder falsch eingegebenen Ausdruck (eine Fehlermeldung wird wie ein leerer Ausdruck behandelt; es ist nicht gleich Null, also bekommen wir ).



vergleichend



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



Boolean operators of equality or inequality operators are supported.



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



Die Funktion ergibt, wenn die Seite existiert, ob sie Inhalt enthält, sichtbar leer ist (enthält Metadaten wie Kategorienlinks oder , aber nicht sichtbar content), ist leer oder ist eine. Nur Seiten, die mit einem Redlink versehen sind, werden als  ausgewertet, auch wenn die Seite früher existierte, aber gelöscht wurde.



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



Wenn eine Seite ein Ziel mit  überprüft, erscheint diese Seite in der -Liste für die Zielseite. Wenn also der Code  live auf dieser Seite  enthalten wäre, wird /Foo  auflisten.

In Wikis, die eine gemeinschaftliche Bilddatenbank nutzen (z.B. Wikimedia Commons), kann  benutzt werden, um zu überprüfen, ob Dateien im lokalen Wiki oder in der externen Bilddatenbank hochgeladen wurden.



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

funktioniert nicht bei Interwiki-Links.

Grenzen von ifexist
wird als „aufwendige Parserfunktion“ eingestuft; nur eine bestimmte Anzahl von ihnen kann auf einer bestimmten Seite eingebunden werden (Funktionen in eingebundenen Vorlagen eingeschlossen). Wenn dieses Limit überschritten wird, geben weitere -Funktionen automatisch falsch zurück, unabhängig davon ob die Zielseite existiert oder nicht, und die Seite wird in Category: eingeordnet. Der Name der kann von der Inhaltssprache deines Wikis abhängen.

Für einige Anwendungsfälle ist es möglich, den Ifexist-Effekt mit CSS zu emulieren, indem die Selektoren  (um Links zu nicht existierenden Seiten auszuwählen) oder   gesteuert wird, kann man das Limit bei Bedarf auch in LocalSettings.php erhöhen.

ifexist und gesuchte Seiten
Eine Seite, die nicht existiert und auf die Verwendung von #ifexist geprüft wurde, erscheint auf den Wanted Pages. Siehe für den Grund und w:Template:Linkless existiert für eine Problemumgehung.

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



Innerhalb der -Eingabe gilt die folgende Syntax:


 * → aktuelle Ebene
 * → Eine Ebene höher
 * → Eine Ebene tiefer in die Unterseite /foo

Wenn  nicht angegeben ist, wird stattdessen der vollständige Seitenname der Seite verwendet:



Ungültige Syntax wie  oder   wird ignoriert. Da nicht mehr als zwei aufeinanderfolgende Punkte erlaubt sind, können Sequenzen wie diese verwendet werden, um aufeinanderfolgende Anweisungen zu trennen:



#switch
Siehe auch: w:Help:Switch parser function

Diese Funktion vergleicht einen Eingabewert mit mehreren Testfällen und gibt eine zugehörige Zeichenfolge zurück, wenn eine Übereinstimmung gefunden wird.

Beispiele:




 * 1) switch mit partiellen Transklusions-Tags kann sich auf eine Konfigurationsdatei auswirken, die es einem Editor, der mit Template-Codierung nicht vertraut ist, ermöglicht, konfigurierbare Elemente anzuzeigen und zu bearbeiten.

Standard
Das  wird zurückgegeben, wenn kein  -String mit dem   übereinstimmt:



In dieser Syntax muss das Standardergebnis der letzte Parameter sein und darf kein rohes Gleichheitszeichen (ein Gleichheitszeichen ohne ) enthalten. Wenn dies der Fall ist, wird dies als Fallvergleich behandelt, und es wird kein Text angezeigt, wenn keine Fälle übereinstimmen. Dies liegt daran, dass der Standardwert nicht definiert wurde (weil er leer ist). Im Falle einer Übereinstimmung jedoch wird der zugehörige String zurückgegeben.



Alternativ kann das Standardergebnis explizit mit einer -Zeichenfolge von " " deklariert werden.

Auf diese Weise deklarierte Standardergebnisse können an beliebiger Stelle innerhalb der Funktion platziert werden:



Wenn der Parameter  weggelassen wird und keine Übereinstimmung gefunden wird, wird kein   zurückgegeben:



Ergebnisse gruppieren
Es ist möglich, dass Werte durchfallen, bei denen mehrere -Strings denselben  -String zurückgeben. Dadurch wird Doppelarbeit minimiert.

Hier geben die Fälle 2, 3 und 4 alle  zurück; Fall 6 und 7 geben beide   zurück. Das " " im letzten Parameter kann im obigen Fall weggelassen werden.

Verwendung mit Parametern
Die Funktion kann mit Parametern als Teststring verwendet werden. In diesem Fall ist es nicht erforderlich, die Pipe nach dem Parameternamen zu platzieren, da es sehr unwahrscheinlich ist, dass Sie die Zeichenfolge „ “ als Groß-/Kleinschreibung festlegen. (Dies ist der Wert, auf den der Parameter standardmäßig gesetzt wird, wenn die Pipe nicht vorhanden ist und der Parameter nicht vorhanden ist oder keinen Wert hat. Siehe .)



Wenn im obigen Fall  gleich   ist, gibt die Funktion   zurück. Wenn es gleich  ist, gibt die Funktion   zurück. Wenn der Parameter leer ist oder nicht existiert, gibt die Funktion  zurück.

Wie im obigen Abschnitt können Fälle kombiniert werden, um ein einziges Ergebnis zu erhalten.



Wenn hier  gleich ,   oder   ist, gibt die Funktion   zurück. Wenn es gleich  ist, gibt die Funktion   zurück. Wenn der Parameter leer ist oder nicht existiert, gibt die Funktion  zurück.

Außerdem kann das Standardergebnis weggelassen werden, wenn Sie nichts zurückgeben möchten, wenn der Testparameterwert keinem der Fälle entspricht.



In diesem Fall gibt die Funktion eine leere Zeichenfolge zurück, es sei denn,  existiert und ist gleich   oder , in diesem Fall gibt sie   bzw. zurück.

Dies hat den gleichen Effekt wie das Deklarieren des Standardergebnisses als leer.



Wenn Sie aus irgendeinem Grund entscheiden, einen Fall als " " festzulegen, gibt die Funktion das Ergebnis dieses Falls zurück, wenn der Parameter nicht existiert oder keinen Wert hat. Der Parameter müsste vorhanden sein und einen anderen Wert als die Zeichenfolge " " haben, um das Standardergebnis der Funktion zurückzugeben.


 * (wenn  nicht existiert oder leer ist):
 * →  Foo 
 * (wenn  den Wert " " hat):
 * →  Bar 
 * (wenn  den Wert " " hat):
 * →  Foo 

In diesem hypothetischen Fall müssten Sie die Pipe zum Parameter hinzufügen.

Vergleiche
Wie bei  wird der Vergleich numerisch durchgeführt, wenn sowohl die Vergleichszeichenfolge als auch die zu testende Fallzeichenfolge numerisch sind; oder als case-sensitive Zeichenfolge ansonsten:





Ein -String kann leer sein:



Sobald eine Übereinstimmung gefunden wurde, werden nachfolgende  ignoriert:



Ist-Gleich-Zeichen
"Case"-Strings dürfen keine rohen Gleichheitszeichen enthalten. Um dies zu umgehen, erstellen Sie eine Vorlage =, die ein einzelnes Gleichheitszeichen enthält:, oder ersetzen Sie das Gleichheitszeichen durch den HTML-Code.

Beispiel:

#ifeq ersetzen
kann verwendet werden, um die Expansionstiefe zu reduzieren.

Zum Beispiel:



ist gleichbedeutend mit



d.h. tief verschachtelt, linear:

Andererseits könnte der Switch-Ersatz kompliziert/unpraktisch für IFs sein, die in beiden Zweigen verschachtelt sind (gezeigt mit Einrückungsalternativen, auf beiden Seiten eingerückt), wodurch ein vollständig symmetrischer Baum entsteht:

#time
Dies Parserfunktion nimmt ein Datum und/oder eine Zeit (im Gregorianischen Kalender) und formatiert es gemäß der gegebenen Syntax. Eine Datum/Zeit-Einheit kann bestimmt werden, der Standardwert ist der Wert des magischen Worts  – d.h. die Zeit, als die Seite zuletzt in HTML übersetzt wurde.



Die Liste der gültigen Formate ist der Tabelle rechts zu entnehmen. Jedes Zeichen im formatierten String, das nicht erkannt wird, wird unverändert ausgegeben; dies betrifft auch Leerzeichen (das System braucht diese nicht für das Interpretieren des Codes). Es gibt zwei Wege, Zeichen innerhalb des Formatierungs-Strings zu umgehen: Zusätzlich wird der Digraph  als einzelnes buchstäbliches "x" interpretiert.
 * 1) Ein linksseitiger Schrägstrich (Backslash) wird als einzelnes buchstäbliches Zeichen interpretiert
 * 2) Zeichen innerhalb doppelten Anführungszeichen werden als buchstäbliche Zeichen interpretiert und die Anführungszeichen entfernt.

Da sich die Liste der Formatierungscodes weiter entwickelt (mit Unterstützung neuer Kalender oder neuer Datumsfelder, die anders berechnet und formatiert werden), sollten Sie alle Literalzeichen (nicht nur ASCII-Buchstaben, die derzeit von Formatierungscodes verwendet werden) mit Escapezeichen versehen, die übergeben werden müssen unverändert durch.

Leider wird das einfache ASCII-Anführungszeichen derzeit noch nicht als einfache Alternative zum Markieren von wörtlichem Text zu den derzeit unterstützten doppelten ASCII-Anführungszeichen erkannt (z, C++...) und Backslashes (die auch in String-Konstanten maskiert werden müssen, die von vielen Sprachen verwendet werden, darunter JSON, C, C++, PHP, JavaScript, Lua). Sie können also immer noch kein wörtliches doppeltes Anführungszeichen einbetten, ohne es mit einem Backslash zu umgehen (oder Sie können stattdessen andere geschweifte, eckige oder quadratische Anführungszeichen verwenden).



Die  kann in jedem von der PHP-Funktion strtotime akzeptierten Format sein. Absolute (z. B. 1 $), relative (z. B. 2 $) und kombinierte Zeiten (z. B. 3 $) werden akzeptiert.


 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 

Der  in ISO 639-3 (?) ermöglicht die Anzeige des Strings in der gewählten Sprache



Der Parameter  gibt an, ob sich das date/time object auf die lokale Zeitzone oder auf UTC bezieht.

Dies ist ein boolescher Parameter: Sein Wert wird bestimmt, indem der Wert des Arguments umgewandelt wird (siehe die offizielle PHP-Dokumentation für Details darüber, wie Strings in boolesche Werte umgewandelt werden).

Vergleiche mit den folgenden Beispielen:





Unix Zeitstempel können in Datumsrechnungen verwendet werden, indem ein  Symbol vorangestellt wird.



Es können vollständige oder Teile von absoluten Datumsangaben angegeben werden, die Funktion "füllt" die fehlenden Datumsteile mit den aktuellen Werten:



Eine vierstellige Zahl wird immer als Jahr interpretiert, niemals als Stunden und Minuten:



Eine sechsstellige Zahl wird wenn möglich als Stunden, Minuten und Sekunden interpretiert, aber andernfalls als Fehler (nicht z.B. als Jahr und Monat):


 * →  Die Eingabe wird als Zeit behandelt statt Jahr- & Monats-Code.
 * →  Obwohl 19:60:09 keine gültige Zeitangabe ist, wird 196009 nicht als September 1960 interpretiert.

Die Funktion führt eine gewisse Menge an Datums-Rechnungen durch:



Die Gesamtlänge der Formatierungszeichenkette der Funktion  ist auf 6000 Zeichen beschränkt.

Zeitzonenprobleme
Es gibt einen Fehler in dieser #time-Parser-Funktion (genauer gesagt in „PHP DateTime“), der die Übergabe von „Nicht-Ganzzahlen“ als relative Zeitzonen-Offsets nicht zulässt. Dieses Problem tritt nicht auf, wenn eine stündliche Zeitzone wie EDT verwendet wird. Zum Beispiel:


 * &rarr;

Indien hat jedoch einen Zeitversatz von +5,5 Stunden von UTC, und daher ermöglicht die Verwendung seiner Zeitzone normalerweise nicht die korrekte Berechnung eines relativen Zeitzonenversatzes. Folgendes passiert:


 * &rarr;

Um dieses Problem zu umgehen, wandeln Sie einfach die Zeit wie folgt in Minuten oder Sekunden um:


 * &rarr;
 * &rarr;

(Tim Starling, der Entwickler dieser Funktion, hat die genaue Syntax für diese Lösung bereitgestellt.)

#timel
Diese Funktion ist identisch mit, wenn der Parameter   auf   gesetzt ist, also verwendet sie immer die Ortszeit des Wikis (wie in  eingestellt).

Der Quelltext dieser Funktion sieht folgendermaßen aus:





Siehe zum Beispiel die folgenden Beispiele:





#titleparts
Diese Funktion trennt einen Seitentitel basierend auf Schrägstrichen in Segmente und gibt dann einige dieser Segmente als Ausgabe zurück.



Wenn der Parameter Anzahl der zurückzugebenden Segmente nicht angegeben ist, wird standardmäßig „0“ verwendet, wodurch alle Segmente ab dem ersten zurückzugebenden Segment (einschließlich) zurückgegeben werden. Wenn der Parameter first segment to return nicht angegeben ist oder „0“ ist, ist er standardmäßig „1“:


 * →  See also.
 * →  See also.

Negative Werte werden für beide Werte akzeptiert. Negative Werte für den Parameter Anzahl der zurückzugebenden Segmente entfernen effektiv Segmente vom Ende der Zeichenfolge. Negative Werte für das erste zurückzugebende Segment bedeuten „beginne mit diesem Segment, zähle von rechts“:


 * →  Entfernt ein Segment vom Ende der Zeichenfolge. Siehe auch.
 * →   Entfernt alle 4 Segmente vom Ende der Zeichenfolge
 * →   Entfernt 5 Segmente vom Ende der Zeichenfolge (mehr als vorhanden)
 * →   Lässt das letzte Segment wiederkehren. Siehe auch.
 * →   Entfernt ein Segment vom Ende der Zeichenfolge und gibt dann das zweite Segment und darüber hinaus zurück
 * →   Beginnen Sie mit dem Kopieren beim vorletzten Element; Streifen Sie ein Segment vom Ende der Zeichenfolge

Vor der Verarbeitung wird der Parameter pagename HTML-dekodiert: Wenn er einige Standard-HTML-Zeicheneinheiten enthält, werden sie in einfache Zeichen konvertiert (intern kodiert mit UTF-8, d. h. die gleiche Kodierung wie in der MediaWiki-Quellseite mit diese Parser-Funktion).


 * Beispielsweise wird jedes Vorkommen von,   oder   in „Seitenname“ durch   ersetzt.
 * Es wird keine weitere Konvertierung von HTML in reinen Text durchgeführt, sodass HTML-Tags in diesem ersten Schritt intakt bleiben, selbst wenn sie in Seitentiteln ungültig sind.

Then the decoded pagename is canonicalized into a standard page title supported by MediaWiki, as much as possible:


 * 1) Alle Unterstriche werden automatisch durch Leerzeichen ersetzt:
 * →  Nicht bah_boo, sondern ohne den Unterstrich im Orginal.
 * 1) The string is split a maximum of 25 times; further slashes are ignored and the 25th element will contain the rest of the string. The string is also limited to 255 characters, as it is treated as a page title:
 * If for whatever reason you needed to push this function to its limit, although very unlikely, it is possible to bypass the 25 split limit by nesting function calls:
 * 1) Finally the first substring is capitalized according to the capitalization settings of the local wiki (if that substring also starts by a local namespace name, that namespace name is also normalized).
 * 1) Finally the first substring is capitalized according to the capitalization settings of the local wiki (if that substring also starts by a local namespace name, that namespace name is also normalized).
 * 1) Finally the first substring is capitalized according to the capitalization settings of the local wiki (if that substring also starts by a local namespace name, that namespace name is also normalized).

{{Warning|1= Certain characters that are illegal in a page title will cause #titleparts to not parse the string:


 * → {{#titleparts: {one/two} | 1 | 1 }}. Führt nicht zum erwarteten: {one
 * → {{#titleparts: page/123 | 1 | 2 }}. Does not work because brackets are illegal in page titles and this parser function does not process links embedded in its input pagename parameter, even when they use the MediaWiki syntax, or any other HTML or MediaWiki tags.
 * → "{{#titleparts: red/#00FF00/blue| 1 | 3 }}". Dies funktioniert nicht weil "#" auch in Seitentiteln nicht verwendet werden kann.

}}

String-Funktionen
All of these functions are integrated from the StringFunctions extension, but are only available if an administrator sets   in.

All of these functions operate in O(n) time complexity, making them safe against DoS attacks.

#len
The #len function returns the length of the given string. Der Quelltext sieht folgendermaßen aus:

The return value is always a number of characters in the source string (after expansions of template invocations, but before conversion to HTML). If no string is specified, the return value is zero.

#pos
The #pos function returns the position of a given search term within the string. Der Quelltext sieht folgendermaßen aus:

The offset parameter, if specified, tells a starting position where this function should begin searching.

If the search term is found, the return value is a zero-based integer of the first position within the string.

If the search term is not found, the function returns an empty string.

#rpos
The #rpos function returns the last position of a given search term within the string. Der Quelltext sieht folgendermaßen aus:

If the search term is found, the return value is a zero-based integer of its last position within the string.

If the search term is not found, the function returns -1.

#sub
The #sub function returns a substring from the given string. Der Quelltext sieht folgendermaßen aus:

The start parameter, if positive (or zero), specifies a zero-based index of the first character to be returned.

Beispiel: führt zu.

führt zu.

If the start parameter is negative, it specifies how many characters from the end should be returned.

Beispiel: führt zu.

The length parameter, if present and positive, specifies the maximum length of the returned string.

Beispiel: führt zu.

If the length parameter is negative, it specifies how many characters will be omitted from the end of the string.

Beispiel: führt zu.

If the start parameter is negative, it specifies how many characters from the end should be returned. The length parameter, if present and positive, specifies the maximum length of the returned string from the starting point.

Beispiel: führt zu.

#count
The #count function returns the number of times a given substring appears within the provided text.

#replace
The #replace function returns the given string with all occurrences of a search term replaced with a replacement term.

If the search term is unspecified or empty, a single space will be searched for.

If the replacement term is unspecified or empty, all occurrences of the search term will be removed from the string.

Currently the syntax doesn't provide a switch to toggle case-sensitivity setting. But you may make use of magic words of formatting as a workaround. (e.g. your_string_here ) For example, if you want to remove the word "Category:" from the string regardless of its case, you may type:
 * Case-insensitive replace :

But the disadvantage is that the output will become all lower-case. If you want to keep the casing after replacement, you have to use multiple nesting levels (i.e. multiple replace calls) to achieve the same thing.

#explode
The #explode function splits the given string into pieces and then returns one of the pieces. Der Quelltext sieht folgendermaßen aus:

The delimiter parameter specifies a string to be used to divide the string into pieces. This delimiter string is then not part of any piece, and when two delimiter strings are next to each other, they create an empty piece between them. If this parameter is not specified, a single space is used. The limit parameter is available in ParserFunctions only, not the standalone StringFunctions version, and allows you to limit the number of parts returned, with all remaining text included in the final part.

The position parameter specifies which piece is to be returned. Pieces are counted from 0. If this parameter is not specified, the first piece is used (piece with number 0). When a negative value is used as position, the pieces are counted from the end. In this case, piece number -1 means the last piece. Beispiele:


 * kehrt wieder
 * kehrt wieder
 * kehrt wieder
 * kehrt wieder

The return value is the position-th piece. If there are fewer pieces than the position specifies, an empty string is returned.

#urldecode
converts the escape characters from an 'URL encoded' string back to readable text. The syntax is:

Notes:
 * This function works by directly exposing PHP's urldecode function.
 * A character-code-reference can be found at www.w3schools.com.
 * The opposite,, has been integrated into MediaWiki as of version 1.18; for examples, see.
 * urldecode was merged from Stringfunctions in 2010, by commit 1b75afd18d3695bdb6ffbfccd0e4aec064785363

Grenzen
Dieses Modul legt drei globale Einstellungen fest:


 * $wgStringFunctionsLimitSearch
 * $wgStringFunctionsLimitReplace
 * $wgStringFunctionsLimitPad

These are used to limit some parameters of some functions to ensure the functions operate in O(n) time complexity, and are therefore safe against DoS attacks.

$wgStringFunctionsLimitSearch
This setting is used by #pos, #rpos, #replace, and #explode. All these functions search for a substring in a larger string while they operate, which can run in O(n*m) and therefore make the software more vulnerable to DoS attacks. By setting this value to a specific small number, the time complexity is decreased to O(n).

This setting limits the maximum allowed length of the string being searched for.

The default value is 30 multibyte characters.

$wgStringFunctionsLimitReplace
This setting is used by #replace. This function replaces all occurrences of one string for another, which can be used to quickly generate very large amounts of data, and therefore makes the software more vulnerable to DoS attacks. This setting limits the maximum allowed length of the replacing string.

The default value is 30 multibyte characters.

Substitution
Parser functions can be substituted by prefixing the hash character with :


 * → the code   will be inserted in the wikitext since the page exists.

Substitution does not work within ; you can use &hellip;  for this purpose.

Weiterleitungen
Especially   could be handy in  to pages including dates, but this does not work.

Umgehung des "Senkrechten Striches" innerhalb Tabellen
Parser functions will mangle syntax and pipe characters, treating all the raw pipe characters as parameter dividers. To avoid this, most wikis used a template    :! with its contents only a raw pipe character, since MW 1.24 a  replaced this kludge. 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. It will then be interpreted as a table row or column separator. Alternatively, raw HTML table syntax can be used, although this is less intuitive and more error-prone.

You can also escape the pipe character for display as a plain, uninterpreted character using an HTML entity:.

Streichung von Leerzeichen
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 strings can be done after putting them in quotation marks.



To prevent the trimming of then and else parts, see m:Template:If. Some people achieve this by using &lt; &gt;  &lt; /nowiki &gt; instead of spaces.


 * → foofoo
 * → foofoo

However, this method can be used to render a single whitespace character only, since the parser squeezes multiple whitespace characters in a row into one.




 * || → || foofoo 
 * }

In this example, the  style is used to force the whitespace to be preserved by the browser, but even with it the spaces are not shown. This happens because the spaces are stripped by the software, before being sent to the browser.

It is possible to workaround this behavior replacing whitespaces with  (breakable space) or   (non-breakable space), since they are not modified by the software:


 * →  foofoo 
 * → foofoo

Beware that not all parameters are created equal. In ParserFunctions, whitespace at the beginning and end is always stripped. In templates, whitespace at the beginning and end is stripped for named parameters and named unnamed parameters but not from unnamed parameters:


 * → foofoo
 * → foofoo
 * → foofoo

Siehe auch

 * m:Help:Calculation
 * m:Help:Newlines and spaces
 * m:Help:Comparison between ParserFunctions syntax and TeX syntax
 * , an (incomplete) list of parser functions added by core and extensions.
 * Module:String löst ab
 * Parser functions for Wikibase (the extensions that enables Wikidata): d:Special:MyLanguage/Wikidata:How to use data on Wikimedia projects
 * Module:String löst ab
 * Parser functions for Wikibase (the extensions that enables Wikidata): d:Special:MyLanguage/Wikidata:How to use data on Wikimedia projects
 * Parser functions for Wikibase (the extensions that enables Wikidata): d:Special:MyLanguage/Wikidata:How to use data on Wikimedia projects