Quelltext der Seite Vorlage:Str replace/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{TemplateData|JSON=
  {
    "description": "Diese Vorlage entfernt Leerzeichen am Anfang und am Ende der in [[#templatedata:1|''Text'']] angegebenen Zeichenkette und ersetzt Textteile durch eine andere Zeichenkette. Alternativ kann eine Ersetzung mittels eines [[regulärer Ausdruck|regulären Ausdrucks]] (Regex) erfolgen.<br>Die beiden Zeichenketten werden vor dem Vergleich getrimmt, es werden also führende und abschließende Leerzeichen entfernt.",
    "params": {
           "1": { "label":       "Text",
                  "description": "Zeichenkette, Eingabetext",
                  "type":        "string",
                  "required":    true,
                  "example":     "Autobahn"
                },
           "2": { "label":       "Suchtext",
                  "description": "<ul>
<li>Der Teiltext, der ersetzt werden soll bzw.</li>
<li>wenn [[#templatedata:5|RegExp]] gesetzt, der reguläre Ausdruck. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter [[Hilfe:Lua/Zeichenketten#Pattern]]. Die wichtigste Einschränkung ist, dass ein Lua-RegExp keine Oder-Angaben (<code>&#124;</code>-Sprachelement) unterstützt.</li>
</ul>",
                  "type":        "string",
                  "required":    true,
                  "example":     "to"
                },
           "3": { "label":       "Ersatztext",
                  "description": "Die Zeichenkette, durch die ersetzt wird.",
                  "type":        "string",
                  "required":    false,
                  "default":     "eine leere Zeichenkette (Länge 0)",
                  "example":     "au"
                },
           "4": { "label":       "Anzahl",
                  "description": "Anzahl der Ersetzungen. ",
                  "type":        "number",
                  "required":    false,
                  "default":     "alle Vorkommen werden ersetzt.",
                  "example":     "2"
                },
           "5": { "label":       "RegExp",
                  "description": "[[Flag_(Informatik)#Abgrenzung|Flag]]: Wenn mit einem Wert belegt, wird [[#templatedata:2|Suchtext]] als regulärer Ausdruck interpretiert.",
                  "type":        "line",
                  "required":    false,
                  "example":     "Ja"
                }
       }
  }
|TOC=1}}

== Kopiervorlagen ==
<pre>{{Str&nbsp;replace | | | | | }}</pre>
Falls Gleichheitszeichen (<code>&#61;</code>) in den Zeichenketten vorkommen:
<pre>{{Str&nbsp;replace|1=|2=|3=|4=|5=}}</pre>

== Beispiele ==
{| class="wikitable"
! Eingabe
! Ausgabe
! Erklärung
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Lilly!|l|s}}</nowiki></code>
| {{nowrap|{{Str replace|Hallo Lilly!|l|s}}}}
| Ersetzt alle Vorkommen von <code>l</code> durch <code>s</code>. Die Vorlage ist case-sensitive.
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Lilly!|l|s|2}}</nowiki></code>
| {{Str replace|Hallo Lilly!|l|s|2}}
| Ersetzt höchstens zwei Vorkommen von <code>l</code> durch <code>s</code>.
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Lilly!|l}}</nowiki></code>
| {{Str replace|Hallo Lilly!|l}}
| Ersetzt <code>l</code> durch einen Leerstring, entfernt also alle <code>l</code>.
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Lilly!| }}</nowiki></code>
| {{nowrap|{{Str replace|Hallo Lilly!| }} }}
| Entfernt alle Leerzeichen ersatzlos.
|-
| colspan="3" | '''mit regulärern Ausdrücken!'''
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Lilly!|[aeiou]|||ja}}</nowiki></code>
| {{Str replace|Hallo Lilly!|[aeiou]|||ja}}
| Entfernt alle Vokale (regulärer Ausdruck!).
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Lilly!|[aeiou]||2|ja}}</nowiki></code>
| {{Str replace|Hallo Lilly!|[aeiou]||2|ja}}
| Entfernt nur die ersten beiden Vokale.
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Lilly!|[%s%p]|||ja}}</nowiki></code>
| {{Str replace|Hallo Lilly!|[%s%p]|||ja}}
| Entfernt [[Leerraum#Unicode|Leerraum]], d.&nbsp;h. Leerzeichen, Zeilenumbrüche, Tabs, usw., sowie [[Interpunktionszeichen in Unicode|Interpunktionen]].
|-
| nowrap | <code><nowiki>{{Str replace| 9 1 62 000 x !|[%s]|||ja}}</nowiki></code>
| {{Str replace| 9 1 62 000 x !|[%s]|||ja}}
| Entfernt [[Leerraum#Unicode|Leerraum]], d.&nbsp;h. Leerzeichen, Zeilenumbrüche, Tabs, usw.
|-
| nowrap | <code><nowiki>{{Str replace|Hallo Lilly!|%!|?||ja}}</nowiki></code>
| {{Str replace|Hallo Lilly!|%!|?||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 Lilly!|([aeiou])|'''%1'''||ja}}</nowiki></code>
| {{Str replace|Hallo Lilly!|([aeiou])|'''%1'''||ja}}
| Sucht alle Vokale, fasst diese zu einer Gruppe (markiert durch Klammerung) zusammen und gibt dann alle zu dieser ersten Gruppe (<code>%1</code>) gehörigen Teile fett aus.
|}

== Siehe auch ==
{{Navigationsleiste Zeichenketten-Vorlagen}}
<includeonly>
{{Dokumentation/Lua |Str}}

[[Kategorie:Vorlage:Syntaxhilfe]]
</includeonly>