Vorlage:Str match/Doku

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

	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.

Diese Vorlage filtert einen Teilstring aus einem übergebenen String mittels eines regulären Ausdrucks (Regex) heraus. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter [1], erweitert unter die in [2] beschriebenen Unicode-Eigenschaften. Die wichtigste Einschränkung ist das Lua-Regexe keine Alternativen (|-Sprachelement) unterstützen.

Parameter

• 1: Der Eingabestring.
• 2: Der anzuwendende reguläre Ausdruck.
• 3 (optional): wenn mittels Klammerung mehrere Gruppen definiert wurden, kann die zurückzugebende Gruppe hier angegeben werden. Falls nicht angegeben, wird 0 (= alle Teilstrings) angenommen.

Beispiele

Eingabe	Ausgabe	Erklärung
{{Str match|eine Zeichenkette als Test|%u%l+}}	Zeichenkette	erstes Wort, das mit einem Großbuchstaben beginnt
{{Str match|Russische Sprache (русский язык)|[Ѐ-ӿ]+}}	русский	erste Zeichenfolge in Kyrillisch (vgl. Unicodeblock Kyrillisch)
{{Str match|Beispieltext|(Bei).+(text)|2}}	text	zweite Gruppe zurückgeben
{{Str match|Beispieltext|(Bei).+(text)|0}}	Beitext	alle Gruppen zurückgeben
{{#if:{{Str match|Beispieltext|spiel}}|ja|nein}} {{#if:{{Str match|Beispieltext|abcde}}|ja|nein}}	ja nein	Überprüfung, ob ein Text einen angegebenen Teilstring enthält

AusklappenVorlagen zur Zeichenkettenverarbeitung

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 letzten n Zeichen {{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 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 {{Str trim}} – entfernt führende und abschließende Leerzeichen

Modul:Str – Basismodul der meisten Vorlagen