Vorlage:Str replace/Doku

Diese Seite ist die Dokumentations-Unterseite der Vorlage:Str replace.

	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.

Eigenschaften der Vorlage
„Str replace“

Projekt	[[{{{projekt}}}]]
Vorlagentyp	Syntaxhilfe
Namensraum	geeignet für Vorlagen
automat. Kategorie	keine
abhängig von	[[Vorlage:|]]
alternativ	Navigationsleiste Zeichenketten-Vorlagen
Bitte binde diese Vorlage nur mit Substitution ein.
Bitte vor Änderung dieser vielfach verwendeten Vorlage die Zustimmung der Gemeinschaft im Skriptorium einholen!

Beschreibung

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

Neben einer einfachen Ersetzung, kann zusätzlich eine Ersetzung mittels eines regulären Ausdrucks (Regex) erfolgen. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter w:Hilfe:Lua/Zeichenketten#Pattern. Die wichtigste Einschränkung ist das Lua-Regexe keine Oder-Angaben (|-Sprachelement) unterstützen.

Kopiervorlage

{{Str replace|||||}}

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 1 oder ja), dann wird Parameter 2 als regulärer Ausdruck interpretiert

Beispiele

Eingabe	Ausgabe	Erklärung
{{Str replace|Hallo Welt.|l|s}}	Hasso West.	ersetze alle Vorkommen von l durch s
{{Str replace|Hallo Welt.|l|s|2}}	Hasso Welt.	ersetze höchstens zwei Vorkommen von l durch s
{{Str replace|Hallo Welt.|[aeiou]|||ja}}	Hll Wlt.	entferne alle Vokale (regulärer Ausdruck!)
{{Str replace|Hallo Welt.|[%s%p]|||ja}}	HalloWelt	entferne Leerraum, d.h. Leerzeichen, Zeilenumbrüche, Tabs, usw., sowie Interpunktionen (regulärer Ausdruck!)
{{Str replace|Hallo Welt.|%.|?||ja}}	Hallo Welt?	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 Welt.|([aeiou])|'''%1'''||ja}}	Hallo Welt.	Suche alle Vokale, fasse diese zu einer Gruppe (markiert durch Klammerung) zusammen und gebe dann alle zu dieser ersten Gruppe (%1) gehörigen Teile fett aus.

Alle Stringvorlagen

• Extraktion
  • Positionsbasiert
    • {{Str left}} – gibt die ersten n Zeichen zurück
    • {{Str right}} – gibt die Zeichen rechts von einer gegebenen Position zurück
    • {{Str rightc}} – gibt die letzten n Zeichen zurück
    • {{Str crop}} – entfernt die n letzten Zeichen
    • {{Str index}} – gibt das Zeichen an einer gegebenen Position zurück
    • {{Str sub}} – gibt die Zeichen von und bis zu einer gegebenen Position zurück
  • Musterbasiert
    • {{Str match}} – gibt eine Teilzeichenkette basierend auf einem Regex 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
• Weiteres = Modul:Str – Basismodul der meisten Vorlagen