Vorlage:Str replace/Doku

Diese Vorlage entfernt Leerzeichen am Anfang und am Ende der in Text angegebenen Zeichenkette und ersetzt Textteile durch eine andere Zeichenkette. Alternativ kann eine Ersetzung mittels eines regulären Ausdrucks (Regex) erfolgen.
Die beiden Zeichenketten werden vor dem Vergleich getrimmt, es werden also führende und abschließende Leerzeichen entfernt.

Vorlagenparameter

Parameter		Beschreibung	Typ	Status
Text	`1`	Zeichenkette, Eingabetext Beispiel Autobahn	Zeichenfolge	erforderlich
Suchtext	`2`	Der Teiltext, der ersetzt werden soll bzw. wenn RegExp gesetzt, der reguläre Ausdruck. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter Hilfe:Lua/Zeichenketten#Pattern. Die wichtigste Einschränkung ist, dass ein Lua-RegExp keine Oder-Angaben (`\|`-Sprachelement) unterstützt. Beispiel to	Zeichenfolge	erforderlich
Ersatztext	`3`	Die Zeichenkette, durch die ersetzt wird. Standard eine leere Zeichenkette (Länge 0) Beispiel au	Zeichenfolge	optional
Anzahl	`4`	Anzahl der Ersetzungen. Standard alle Vorkommen werden ersetzt. Beispiel 2	Nummer	optional
RegExp	`5`	Flag: Wenn mit einem Wert belegt, wird Suchtext als regulärer Ausdruck interpretiert. Beispiel Ja	Zeile	optional

Kopiervorlagen

{{Str replace | | | | | }}

Falls Gleichheitszeichen (=) in den Zeichenketten vorkommen:

{{Str replace|1=|2=|3=|4=|5=}}

Beispiele

Eingabe	Ausgabe	Erklärung
`{{Str replace\|Hallo Lilly!\|l\|s}}`	Hasso Lissy!	Ersetzt alle Vorkommen von `l` durch `s`. Die Vorlage ist case-sensitive.
`{{Str replace\|Hallo Lilly!\|l\|s\|2}}`	Hasso Lilly!	Ersetzt höchstens zwei Vorkommen von `l` durch `s`.
`{{Str replace\|Hallo Lilly!\|l}}`	Hao Liy!	Ersetzt `l` durch einen Leerstring, entfernt also alle `l`.
`{{Str replace\|Hallo Lilly!\| }}`	HalloLilly!	Entfernt alle Leerzeichen ersatzlos.
mit regulären Ausdrücken!
`{{Str replace\|Hallo Lilly!\|[aeiou]\|\|\|ja}}`	Hll Llly!	Entfernt alle Vokale (regulärer Ausdruck!).
`{{Str replace\|Hallo Lilly!\|[aeiou]\|\|2\|ja}}`	Hll Lilly!	Entfernt nur die ersten beiden Vokale.
`{{Str replace\|Hallo Lilly!\|[%s%p]\|\|\|ja}}`	HalloLilly	Entfernt Leerraum, d. h. Leerzeichen, Zeilenumbrüche, Tabs, usw., sowie Interpunktionen.
`{{Str replace\| 9 1 62 000 x !\|[%s]\|\|\|ja}}`	9162000x!	Entfernt Leerraum, d. h. Leerzeichen, Zeilenumbrüche, Tabs, usw.
`{{Str replace\|Hallo Lilly!\|%!\|?\|\|ja}}`	Hallo Lilly?	Wichtig: Wenn reguläre Ausdrücke verwendet werden und Zeichen ersetzt werden sollen, die selber Teil des Zeichenvorrats für reguläre Ausdrücke sind, d.h. `^$.()[]?*+-`, so müssen diese mit `%` escapet werden.
`{{Str replace\|Hallo Lilly!\|([aeiou])\|'''%1'''\|\|ja}}`	Hallo Lilly!	Sucht alle Vokale, fasst diese zu einer Gruppe (markiert durch Klammerung) zusammen und gibt dann alle zu dieser ersten Gruppe (`%1`) gehörigen Teile fett aus.

Siehe auch