Hilfe:Vorlagenprogrammierung/Parserfunktionen/Textmanipulation

Parserfunktionen zur Textmanipulation verändern die Ausgabe von Text direkt im Wikitext. Sie dienen nicht der Logiksteuerung, sondern der Umformung, Anpassung oder sprachabhängigen Darstellung von Inhalten.

Die hier beschriebenen Funktionen gehören zum Core von MediaWiki und stehen unabhängig von optionalen String-Parserfunktionen zur Verfügung.

Groß- und Kleinschreibung[Bearbeiten | Quelltext bearbeiten]

Funktion	Ausgabe (Beispiel)	Erklärung
`{{lc: Beispieltext}}`	beispieltext	Wandelt den gesamten Text in Kleinbuchstaben um.
`{{uc: beispieltext}}`	BEISPIELTEXT	Wandelt den gesamten Text in Großbuchstaben um.
`{{ucfirst: beispieltext}}`	Beispieltext	Setzt den ersten Buchstaben des Textes groß.
`{{lcfirst: Beispieltext}}`	beispieltext	Setzt den ersten Buchstaben des Textes klein.

Zahlen- und Sprachausgabe[Bearbeiten | Quelltext bearbeiten]

Funktion	Ausgabe (Beispiel)	Erklärung
`{{formatnum: 1234567}}`	1.234.567	Formatiert Zahlen gemäß Sprache und Locale (z. B. Tausender- und Dezimaltrennzeichen).
`{{padleft: 7 \| 3 \| 0 }}`	007	Füllt den Text links auf, bis die gewünschte Länge erreicht ist.
`{{padright: 7 \| 3 \| 0 }}`	700	Füllt den Text rechts auf, bis die gewünschte Länge erreicht ist.
`{{plural: 2 \| Element \| Elemente}}`	Elemente	Wählt eine Textform abhängig von Zahl und sprachlichen Pluralregeln.
`{{gender: Benutzername \| männlich \| weiblich \| divers}}`	divers	Wählt eine Textform abhängig vom im Benutzerkonto hinterlegten Geschlecht. (Wenn unbekannt wird divers oder maskulin ausgegeben. Wirksam vor allem in Systemnachrichten und lokalisierten Texten.

Hinweise zur Verwendung[Bearbeiten | Quelltext bearbeiten]

Die beschriebenen Funktionen verändern ausschließlich die Textausgabe. Sie führen keine logischen Entscheidungen aus und ersetzen keine Bedingungen oder Berechnungen.

Sprachabhängige Funktionen wie plural und gender entfalten ihre volle Wirkung insbesondere im Zusammenhang mit lokalisierten Systemnachrichten. Im normalen Wikitext sind sie nur eingeschränkt sinnvoll.

Für komplexere Textverarbeitung, wiederverwendbare Logik oder strukturierte Ausgaben sollten mit Lua geschriebene Module verwendet werden.

Abgrenzung[Bearbeiten | Quelltext bearbeiten]

MediaWiki stellt zusätzlich optionale Parserfunktionen für Stringverarbeitung bereit (z. B. zum Kürzen, Ersetzen oder Zählen von Text).

Abschnittstransklusion

Die optionalen String-Funktionen der Erweiterung ParserFunctions (z. B. #len oder #sub) sind in Wikonia nicht aktiviert. Stattdessen stehen die gleichnamigen oder erweiterten Lua-Funktionen des Modul:String zur Verfügung, die in vielen Wikimedia-Wikis als Standardlösung verwendet werden. Die folgende Tabelle zeigt die üblichen ParserFunctions-Stringfunktionen und jeweils passende Alternativen im Modul:

ParserFunctions	Enstprechung im Modul:String	Hinweis
`#len`	`{{#invoke:String\|len\|text}}`	Zeichenanzahl bestimmen
`#sub`	`{{#invoke:String\|sub\|text\|start\|end}}`	Teilstring
`#pos`	`{{#invoke:String\|pos\|text\|index}}`	Zeichen an Position
`#rpos`	–	keine Rückwärtssuche im Modul vorhanden
`#replace`	`{{#invoke:String\|replace\|source\|pattern\|replacement\|limit\|plain}}`	Ersetzt ein Muster
`#count`	`{{#invoke:String\|count\|source\|pattern\|plain}}`	Zählt Treffer eines Musters
`#match`	`{{#invoke:String\|match\|source\|pattern\|start\|match_number\|plain\|nomatch}}`	Muster auslesen
`#explode`	–	keine Split-Funktion im Modul vorhanden
`#urldecode`	–	vom Modul nicht abgedeckt

Dieser Abschnitt wurde von dieser Seite eingebunden.

Siehe auch

Hilfe:Vorlagen – Verwendung von Vorlagen
Hilfe:Vorlagenprogrammierung – Einstieg in die Programmierung
/Bedingungen – Funktionen zu Konditionen (if, switch, etc.)
/Datum und Zeit – Auswertung und Darstellung von Zeiten
/Struktur und Titel – Wiki-Titel und Unterseiten auswerten
Hilfe:Magische Wörter – Globale Werte auslesen