Vorlage:Str replace/Doku

Diese Vorlage erlaubt das Ersetzen eines Teiles einer Zeichenkette (String) durch eine andere Zeichenkette. Das kann eine einfache Ersetzung sein, es sind aber auch reguläre Ausdrücke (Regex) der Programmiersprache Lua möglich. Lua-Regex unterstützt keine Oder-Angabe (|).

Kopiervorlage

{{Str replace|Text|BestehenderTeilstring|NeuerTeilstring|AnzahlErsetzungen|Regex?}}

Parameter

• 1: (Pflicht) Die vorgegebene Zeichenkette
• 2: (Pflicht) Die zu ersetzende Teilzeichenkette
• 3: (Pflicht) Die neue Teilzeichenkette
• 4: (Optional) Anzahl der Ersetzungen. Ohne Angabe werden alle Vorkommen ersetzt.
• 5: (Optional) Wenn angegeben (vorzugsweise mit 1 (true) oder ja), dann wird Parameter 2 als regulärer Ausdruck interpretiert.

Beispiele

Beispiel	Ergebnis	Erklärung
{{Str replace|Eisenbahn|Eisen|Auto}}	Autobahn	Eisen wird durch Auto ersetzt
{{Str replace|Eisenbahn|n|l}}	Eiselbahl	Alle Vorkommen des Buchstaben n werden durch den Buchstaben l ersetzt
{{Str replace|Eisenbahn|n|l|1}}	Eiselbahn	Das erste Vorkommen des Buchstaben n wird durch den Buchstaben l ersetzt
{{Str replace|Eisenbahn|n}}	Eisebah	Alle Vorkommen des Buchstaben n werden durch einen Leerstring ersetzt, also entfernt
{{Str replace|Eisenbahn|[aeiou]|||ja}}	Esnbhn	Alle Vokale (Selbstlaute) werden mittels eines regulären Ausdrucks (Regex) entfernt
{{Str replace|Eisenbahn.|%.|?||ja}}	Eisenbahn?	Der Punkt wird durch ein Fragezeichen mittels einen regulären Ausdrucks (Regex) ersetzt. Wenn Zeichen ersetzt werden sollen, die selbst Teil des Zeichenvorrats für reguläre Ausdrücke sind (^$.()[]?*+-), dann müssen diese mit dem Escape-Zeichen % angegeben werden.

Vorlagen zur Zeichenkettenverarbeitung

Vorlagen zur Zeichenkettenverarbeitung
Extraktion
	{{Str left}}	gibt die ersten n Zeichen zurück
	{{Str right}}	gibt die Zeichen rechts ab der angegebenen Position zurück
	{{Str rightc}}	gibt die letzten n Zeichen zurück
	{{Str crop}}	gibt die Zeichen ausgenommen der letzten n zurück
	{{Str index}}	gibt das Zeichen an der angegebenen Position n zurück
	{{Str sub}}	gibt n Zeichen ab der angegebenen Position zurück
	{{Str match}}	gibt Teilzeichenkette basierend auf einem regulären Ausdruck (Regex) zurück
Länge
	{{Str len}}	gibt Länge der Zeichenkette zurück
	{{Str ≥ len}}	überprüft Zeichenkette auf angegebene Mindestlänge
Suche
	{{Str find}}	gibt die Position des Gesuchten in einer Zeichenkette zurück
Bearbeiten
	{{Str replace}}	ersetzt Teile einer Zeichenkette
	{{Str trim}}	entfernt führende und abschließende Leerzeichen

Lua

Diese Vorlage wurde ganz oder teilweise mit der Programmiersprache Lua erstellt.

• Module sind mit #invoke eingebunden.
• Im Quelltext-Modus dieser Vorlage sieht man, welche(s) Modul(e) in dieser Vorlage eingebunden ist/sind.
• In der Dokumentation der einzelnen Module findet man ggf. weitere Hinweise.