Vorlage:Str replace/Doku

Diese Vorlage erlaubt das Ersetzen von Textteilen durch eine andere Zeichenkette.

Neben einer einfachen Ersetzung, kann zusätzlich eine Ersetzung mittels eines regulären Ausdrucks (Regex) erfolgen. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter [1], erweitert unter die in [2] beschriebenen Unicode-Eigenschaften. Die wichtigste Einschränkung ist das Lua-Regexe keine Alternativen (|-Sprachelement) unterstützen.

Parameter

• 1: Der Eingabetext.
• 2: Der Teiltext, der ersetzt werden soll.
• 3: Die Zeichenkette, durch die ersetzt wird.
• 4: (optional) Anzahl der Ersetzungen. Wenn nicht angegeben, werden alle Vorkommen ersetzt.
• 5: (optional) wenn mit einem Wert belegt (vorzugsweise 1 oder ja), dann wird Parameter 2 als regulärer Ausdruck interpretiert

Beispiele

Eingabe	Ausgabe	Erklärung
{{Str replace|Hallo Welt.|l|s}}	löschen	ersetze alle Vorkommen von l durch s
{{Str replace|Hallo Welt.|l|s|2}}	löschen	ersetze höchstens zwei Vorkommen von l durch s
{{Str replace|Hallo Welt.|[aoe]|||ja}}	löschen	entferne alle Vokale (regulärer Ausdruck!)
{{Str replace|Hallo Welt.|[%s%p]|||ja}}	löschen	entferne Leerraum, d.h. Leerzeichen, Zeilenumbrüche, Tabs, usw., sowie Interpunktionen (regulärer Ausdruck!)
{{Str replace|Hallo Welt.|%.|?||ja}}	löschen	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 Welt.|([aoe])|'''%1'''||ja}}	löschen	Suche alle Vokale, fasse diese zu einer Gruppe (markiert durch Klammerung) zusammen und gebe dann alle zu dieser ersten Gruppe (%1) gehörigen Teile fett aus.