Vorlage:Str replace

aus Wikipedia, der freien Enzyklopädie
Zur Navigation springen Zur Suche springen

Dokumentation

Diese Vorlage entfernt Leerzeichen am Anfang und am Ende der in Text angegebenen Zeichenkette und ersetzt Textteile durch eine andere Zeichenkette. Alternativ kann eine Ersetzung mittels eines regulären Ausdrucks (Regex) erfolgen.
Die beiden Zeichenketten werden vor dem Vergleich getrimmt, es werden also führende und abschließende Leerzeichen entfernt.

Vorlagenparameter

ParameterBeschreibungTypStatus
Text1
Zeichenkette, Eingabetext
Beispiel
Autobahn
Mehrzeiliger Text erforderlich
Suchtext2
  • Der Teiltext, der ersetzt werden soll bzw.
  • wenn 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 (|-Sprachelement) unterstützt.
Beispiel
to
Mehrzeiliger Text erforderlich
Ersatztext3
Die Zeichenkette, durch die ersetzt wird.
Standard
eine leere Zeichenkette (Länge 0)
Beispiel
au
Mehrzeiliger Text optional
Anzahl4
Anzahl der Ersetzungen.
Standard
alle Vorkommen werden ersetzt.
Beispiel
2
Zahlenwert optional
RegExp5
Flag: Wenn mit einem Wert belegt, wird Suchtext als regulärer Ausdruck interpretiert.
Beispiel
Ja
Einzeiliger Text optional

Diese Vorlage entfernt Leerzeichen am Anfang und am Ende der in Text angegebenen Zeichenkette und ersetzt Textteile durch eine andere Zeichenkette. Alternativ kann eine Ersetzung mittels eines regulären Ausdrucks (Regex) erfolgen. Die beiden Zeichenketten werden vor dem Vergleich getrimmt, es werden also führende und abschließende Leerzeichen entfernt.

Vorlagenparameter[Vorlagendaten bearbeiten ]

ParameterBeschreibungTypStatus
Text1

Zeichenkette, Eingabetext

Beispiel
Autobahn
Mehrzeiliger Texterforderlich
Suchtext2

Der Teiltext, der ersetzt werden soll bzw. wenn 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 (|-Sprachelement) unterstützt.

Beispiel
to
Mehrzeiliger Texterforderlich
Ersatztext3

Die Zeichenkette, durch die ersetzt wird.

Standard
eine leere Zeichenkette (Länge 0)
Beispiel
au
Mehrzeiliger Textoptional
Anzahl4

Anzahl der Ersetzungen.

Standard
alle Vorkommen werden ersetzt.
Beispiel
2
Zahlenwertoptional
RegExp5

Flag: Wenn mit einem Wert belegt, wird Suchtext als regulärer Ausdruck interpretiert.

Beispiel
Ja
Einzeiliger Textoptional

Kopiervorlagen

{{Str replace | | | | | }}

Falls Gleichheitszeichen (=) in den Zeichenketten vorkommen: 

{{Str replace|1=|2=|3=|4=|5=}}

Beispiele

Eingabe Ausgabe Erklärung
{{Str replace|Hallo Lilly!|l|s}} Hasso Lissy! Ersetzt alle Vorkommen von l durch s. Die Vorlage ist case-sensitive.
{{Str replace|Hallo Lilly!|l|s|2}} Hasso Lilly! Ersetzt höchstens zwei Vorkommen von l durch s.
{{Str replace|Hallo Lilly!|l}} Hao Liy! Ersetzt l durch einen Leerstring, entfernt also alle l.
{{Str replace|Hallo Lilly!| }} HalloLilly! Entfernt alle Leerzeichen ersatzlos.
mit regulären Ausdrücken!
{{Str replace|Hallo Lilly!|[aeiou]|||ja}} Hll Llly! Entfernt alle Vokale (regulärer Ausdruck!).
{{Str replace|Hallo Lilly!|[aeiou]||2|ja}} Hll Lilly! Entfernt nur die ersten beiden Vokale.
{{Str replace|Hallo Lilly!|[%s%p]|||ja}} HalloLilly Entfernt Leerraum, d. h. Leerzeichen, Zeilenumbrüche, Tabs, usw., sowie Interpunktionen.
{{Str replace| 9 1 62 000 x !|[%s]|||ja}} 9162000x! Entfernt Leerraum, d. h. Leerzeichen, Zeilenumbrüche, Tabs, usw.
{{Str replace|Hallo Lilly!|%!|?||ja}} Hallo Lilly? 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 Lilly!|([aeiou])|'''%1'''||ja}} Hallo Lilly! Sucht alle Vokale, fasst diese zu einer Gruppe (markiert durch Klammerung) zusammen und gibt dann alle zu dieser ersten Gruppe (%1) gehörigen Teile fett aus.

Siehe auch

Vorlagen zur Zeichenkettenverarbeitung
Extraktion
Positionsbasiert
  • {{Str left}} – gibt die ersten n Zeichen zurück
  • {{Str right}} – gibt die Zeichen ausgenommen der ersten n zurück
  • {{Str rightc}} – gibt die letzten n Zeichen zurück
  • {{Str crop}} – gibt die Zeichen ausgenommen der letzten n zurück
  • {{Str index}} – gibt das Zeichen an einer gegebenen Position zurück
  • {{Str sub}} – gibt n Zeichen ab einer gegebenen Position zurück
Musterbasiert
  • {{Str match}} – gibt eine Teilzeichenkette basierend auf einem RegExp zurück
Länge
  • {{Str len}} – gibt die Länge der Zeichenkette zurück
  • {{Str ≥ len}} – überprüft ob die Zeichenkette die angegebene Mindestlänge hat
Suche
  • {{Str find}} – gibt die Position des Gesuchten in einer Zeichenkette zurück
Bearbeiten
  • {{Str replace}} – ersetzt Teile einer Zeichenkette
  • {{Str trim}} – entfernt führende und abschließende Leerzeichen
Modul:Str – Basismodul der meisten Vorlagen

Lua

Diese Vorlage wurde ganz oder teilweise mit Hilfe der Programmiersprache Lua erstellt.

Die Module sind mit #invoke eingebunden. In der Dokumentation der einzelnen Module finden sich auch weitere Hinweise zu Rückfragen.

Verwendetes Modul: Str

Werkzeuge

Bei technischen Fragen zu dieser Vorlage kannst du dich auch an die Vorlagenwerkstatt wenden. Inhaltliche Fragen und Vorschläge gehören zunächst auf die Diskussionsseite. Sie können ggf. auch an eine passende Redaktion, Portal usw. gerichtet werden.

Navigationsmenü