Quelltext der Seite Vorlage:Str replace/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{Lua-Hinweis}}

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

Neben einer einfachen Ersetzung, kann zusätzlich eine Ersetzung mittels eines [[Wikipedia:regulärer Ausdruck|regulären Ausdrucks]] (Regex) erfolgen. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter [//www.mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual#Patterns], erweitert unter die in [//www.mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual#Ustring_patterns] beschriebenen [[Wikipedia:Liste der Unicode-Eigenschaften|Unicode-Eigenschaften]]. Die wichtigste Einschränkung ist das Lua-Regexe keine Alternativen (<tt>|</tt>-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 <code>1</code> oder <code>ja</code>), dann wird Parameter 2 als regulärer Ausdruck interpretiert

== Beispiele ==
{| class="wikitable"
! Eingabe || Ausgabe || Erklärung
|-
| nowrap | <tt><nowiki>{{Str replace|Hallo Welt.|l|s}}</nowiki></tt>
| {{Str replace|Hallo Welt.|l|s}}
| ersetze alle Vorkommen von <tt>l</tt> durch <tt>s</tt>
|-
| nowrap | <tt><nowiki>{{Str replace|Hallo Welt.|l|s|2}}</nowiki></tt>
| {{Str replace|Hallo Welt.|l|s|2}}
| ersetze höchstens zwei Vorkommen von <tt>l</tt> durch <tt>s</tt>
|-
| nowrap | <tt><nowiki>{{Str replace|Hallo Welt.|[aoe]|||ja}}</nowiki></tt>
| {{Str replace|Hallo Welt.|[aoe]|||ja}}
| entferne alle Vokale (regulärer Ausdruck!)
|-
| nowrap | <tt><nowiki>{{Str replace|Hallo Welt.|[%s%p]|||ja}}</nowiki></tt>
| {{Str replace|Hallo Welt.|[%s%p]|||ja}}
| entferne [[Wikipedia:Leerraum#Unicode|Leerraum]], d.h. Leerzeichen, Zeilenumbrüche, Tabs, usw., sowie [[Wikipedia:Interpunktionszeichen in Unicode|Interpunktionen]] (regulärer Ausdruck!)
|-
| nowrap | <tt><nowiki>{{Str replace|Hallo Welt.|%.|?||ja}}</nowiki></tt>
| {{Str replace|Hallo Welt.|%.|?||ja}}
| ''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. <tt>^$.()[]?*+-</tt>, so müssen diese mit <tt>%</tt> [[Wikipedia:Escapezeichen|escapet]] werden.
|-
| nowrap | <tt><nowiki>{{Str replace|Hallo Welt. Ich bin da!|([AEOIUaeoiu])|'''%1'''||ja}}</nowiki></tt>
| {{Str replace|Hallo Welt. Ich bin da!|([AEOIUaeoiu])|'''%1'''||ja}}
| Suche alle Vokale, fasse diese zu einer Gruppe (markiert durch Klammerung) zusammen und gebe dann alle zu dieser ersten Gruppe (<tt>%1</tt>) gehörigen Teile fett aus.
|}

{{Navigationsleiste Zeichenketten-Vorlagen}}

{{Wikipedia}}