Vorlage:Str replace/Doku: Unterschied zwischen den Versionen

Aus CivWiki
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: „<noinclude>{{Dokumentation/Dokuseite}}</noinclude> {{Lua-Hinweis}} Diese Vorlage erlaubt das Ersetzen von Textteilen durch eine andere Zeichenkette. Neben ei…“)
 
(Der Seiteninhalt wurde durch einen anderen Text ersetzt: „löschen“)
 
Zeile 1: Zeile 1:
<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
+
löschen
{{Lua-Hinweis}}
 
 
 
Diese Vorlage erlaubt das Ersetzen von Textteilen durch eine andere Zeichenkette.
 
 
 
Neben einer einfachen Ersetzung, kann zusätzlich eine Ersetzung mittels eines [[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 [[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 [[Leerraum#Unicode|Leerraum]], d.h. Leerzeichen, Zeilenumbrüche, Tabs, usw., sowie [[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> [[Escapezeichen|escapet]] werden.
 
|-
 
| nowrap | <tt><nowiki>{{Str replace|Hallo Welt.|([aoe])|'''%1'''||ja}}</nowiki></tt>
 
| {{Str replace|Hallo Welt.|([aoe])|'''%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.
 
|}
 

Aktuelle Version vom 25. Oktober 2014, 18:18 Uhr

löschen