HoZi: 1 Version importiert

2021-03-21T17:13:39Z

1 Version importiert

de>Sarang: typo

2021-01-12T11:29:06Z

typo

Neue Seite

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{Lua-Vorlage|1=Str}}

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 [[Hilfe:Lua/Zeichenketten#Pattern]]. Die wichtigste Einschränkung ist dass Lua-Regexe keine Oder-Angaben (<code>|</code>-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 | <code><nowiki>{{Str replace|Hallo Welt.|l|s}}</nowiki></code>
| {{Str replace|Hallo Welt.|l|s}}
| ersetze alle Vorkommen von <code>l</code> durch <code>s</code>
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Welt.|l|s|2}}</nowiki></code>
| {{Str replace|Hallo Welt.|l|s|2}}
| ersetze höchstens zwei Vorkommen von <code>l</code> durch <code>s</code>
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Welt.|l}}</nowiki></code>
| {{Str replace|Hallo Welt.|l}}
| ersetze <code>l</code> durch einen Leerstring, entfernt die Zeichen also ersatzlos
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Welt.|[aeiou]|||ja}}</nowiki></code>
| {{Str replace|Hallo Welt.|[aeiou]|||ja}}
| entferne alle Vokale (regulärer Ausdruck!)
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Welt.|[%s%p]|||ja}}</nowiki></code><br><code><nowiki>{{Str replace| 9 1 62 000 x|[%s]|||ja}}</nowiki></code>
| {{Str replace|Hallo Welt.|[%s%p]|||ja}}<br>{{Str replace| 9 1 62 000 x|[%s]|||ja}}
| entferne [[Leerraum#Unicode|Leerraum]], d.h. Leerzeichen, Zeilenumbrüche, Tabs, usw., sowie [[Interpunktionszeichen in Unicode|Interpunktionen]] (regulärer Ausdruck!)
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Welt.|%.|?||ja}}</nowiki></code>
| {{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. <code>^$.()[]?*+-</code>, so müssen diese mit <code>%</code> [[Escapezeichen|escapet]] werden.
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Welt.|([aeiou])|'''%1'''||ja}}</nowiki></code>
| {{Str replace|Hallo Welt.|([aeiou])|'''%1'''||ja}}
| Suche alle Vokale, fasse diese zu einer Gruppe (markiert durch Klammerung) zusammen und gebe dann alle zu dieser ersten Gruppe (<code>%1</code>) gehörigen Teile fett aus.
|}
<includeonly>[[Kategorie:Vorlage:Syntaxhilfe]]</includeonly>

{{Navigationsleiste Zeichenketten-Vorlagen}}

← Nächstältere Version	Version vom 21. März 2021, 17:13 Uhr
(kein Unterschied)

Vorlage:Str replace/Doku - Versionsgeschichte

HoZi: 1 Version importiert

de>Sarang: typo